@gotgenes/pi-permission-system 18.1.1 → 18.2.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 (133) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/docs/configuration.md +11 -0
  3. package/package.json +1 -2
  4. package/src/access-intent/access-path.ts +29 -4
  5. package/src/access-intent/bash/bash-path-resolver.ts +39 -18
  6. package/src/access-intent/bash/msys-bash-tokens.ts +64 -0
  7. package/src/extension-config.ts +7 -0
  8. package/src/forwarded-permissions/permission-forwarder.ts +6 -3
  9. package/src/handlers/gates/helpers.ts +1 -1
  10. package/src/handlers/gates/runner.ts +22 -0
  11. package/src/index.ts +10 -6
  12. package/src/path-normalizer.ts +105 -2
  13. package/src/permission-manager.ts +21 -1
  14. package/src/permission-prompter.ts +10 -16
  15. package/src/prompting-gateway.ts +13 -17
  16. package/src/rule.ts +21 -1
  17. package/src/status.ts +1 -1
  18. package/src/yolo-mode.ts +0 -30
  19. package/test/access-intent/access-path.test.ts +0 -277
  20. package/test/access-intent/bash/node-text.test.ts +0 -148
  21. package/test/access-intent/bash/parser.test.ts +0 -19
  22. package/test/access-intent/bash/program.test.ts +0 -673
  23. package/test/access-intent/bash/token-classification.test.ts +0 -363
  24. package/test/access-intent/bash/token-collection.test.ts +0 -300
  25. package/test/active-agent.test.ts +0 -155
  26. package/test/async-cache.test.ts +0 -48
  27. package/test/bash-arity.test.ts +0 -144
  28. package/test/bash-external-directory.test.ts +0 -1022
  29. package/test/builtin-tool-input-formatters.test.ts +0 -109
  30. package/test/canonicalize-path.test.ts +0 -119
  31. package/test/composition-root.test.ts +0 -698
  32. package/test/config-loader.test.ts +0 -740
  33. package/test/config-modal.test.ts +0 -320
  34. package/test/config-paths.test.ts +0 -83
  35. package/test/config-pipeline.test.ts +0 -90
  36. package/test/config-reporter.test.ts +0 -147
  37. package/test/config-store.test.ts +0 -466
  38. package/test/decision-audit.test.ts +0 -72
  39. package/test/decision-reporter.test.ts +0 -112
  40. package/test/denial-messages.test.ts +0 -714
  41. package/test/detect-permissive-bash-fallback.test.ts +0 -56
  42. package/test/expand-home.test.ts +0 -93
  43. package/test/extension-config.test.ts +0 -129
  44. package/test/extension-paths.test.ts +0 -108
  45. package/test/forwarded-permissions/io.test.ts +0 -251
  46. package/test/forwarding-manager.test.ts +0 -200
  47. package/test/handlers/before-agent-start.test.ts +0 -314
  48. package/test/handlers/external-directory-integration.test.ts +0 -515
  49. package/test/handlers/external-directory-session-dedup.test.ts +0 -175
  50. package/test/handlers/external-directory-symlink-acceptance.test.ts +0 -167
  51. package/test/handlers/gates/bash-command-metamorphic.test.ts +0 -88
  52. package/test/handlers/gates/bash-command.test.ts +0 -257
  53. package/test/handlers/gates/bash-external-directory.test.ts +0 -268
  54. package/test/handlers/gates/bash-path.test.ts +0 -346
  55. package/test/handlers/gates/candidate-check.test.ts +0 -52
  56. package/test/handlers/gates/external-directory-messages.test.ts +0 -85
  57. package/test/handlers/gates/external-directory-policy.test.ts +0 -134
  58. package/test/handlers/gates/external-directory.test.ts +0 -267
  59. package/test/handlers/gates/helpers.test.ts +0 -165
  60. package/test/handlers/gates/path.test.ts +0 -369
  61. package/test/handlers/gates/runner.test.ts +0 -408
  62. package/test/handlers/gates/skill-input-gate-pipeline.test.ts +0 -176
  63. package/test/handlers/gates/skill-input.test.ts +0 -128
  64. package/test/handlers/gates/skill-read.test.ts +0 -161
  65. package/test/handlers/gates/tool-call-gate-pipeline.test.ts +0 -356
  66. package/test/handlers/gates/tool.test.ts +0 -244
  67. package/test/handlers/input-events.test.ts +0 -168
  68. package/test/handlers/input.test.ts +0 -199
  69. package/test/handlers/lifecycle.test.ts +0 -221
  70. package/test/handlers/tool-call-boundary.test.ts +0 -145
  71. package/test/handlers/tool-call-events.test.ts +0 -277
  72. package/test/handlers/tool-call.test.ts +0 -395
  73. package/test/handlers/validate-requested-tool.test.ts +0 -92
  74. package/test/helpers/external-directory-fixtures.ts +0 -269
  75. package/test/helpers/gate-fixtures.ts +0 -316
  76. package/test/helpers/handler-fixtures.ts +0 -335
  77. package/test/helpers/make-fake-pi.ts +0 -100
  78. package/test/helpers/manager-harness.ts +0 -112
  79. package/test/helpers/session-fixtures.ts +0 -199
  80. package/test/input-normalizer.test.ts +0 -325
  81. package/test/logging.test.ts +0 -51
  82. package/test/mcp-targets.test.ts +0 -233
  83. package/test/node-modules-discovery.test.ts +0 -97
  84. package/test/normalize.test.ts +0 -247
  85. package/test/path-containment.test.ts +0 -161
  86. package/test/path-normalization.test.ts +0 -233
  87. package/test/path-normalizer.test.ts +0 -196
  88. package/test/path-surfaces.test.ts +0 -55
  89. package/test/pattern-suggest.test.ts +0 -248
  90. package/test/permission-dialog.test.ts +0 -205
  91. package/test/permission-event-rpc.test.ts +0 -560
  92. package/test/permission-events.test.ts +0 -400
  93. package/test/permission-forwarder.test.ts +0 -370
  94. package/test/permission-forwarding.test.ts +0 -315
  95. package/test/permission-gate.test.ts +0 -269
  96. package/test/permission-manager-unified.test.ts +0 -3714
  97. package/test/permission-merge.test.ts +0 -61
  98. package/test/permission-prompter.test.ts +0 -518
  99. package/test/permission-prompts.test.ts +0 -363
  100. package/test/permission-resolver.test.ts +0 -277
  101. package/test/permission-session.test.ts +0 -404
  102. package/test/permission-ui-prompt.test.ts +0 -146
  103. package/test/permissions-service.test.ts +0 -192
  104. package/test/pi-infrastructure-read.test.ts +0 -432
  105. package/test/policy-loader.test.ts +0 -561
  106. package/test/prompting-gateway.test.ts +0 -231
  107. package/test/rule.test.ts +0 -650
  108. package/test/safe-system-paths.test.ts +0 -46
  109. package/test/scope-merge.test.ts +0 -116
  110. package/test/service-lifecycle.test.ts +0 -163
  111. package/test/service.test.ts +0 -261
  112. package/test/session-approval.test.ts +0 -75
  113. package/test/session-logger.test.ts +0 -200
  114. package/test/session-rules.test.ts +0 -321
  115. package/test/session-start.test.ts +0 -112
  116. package/test/skill-prompt-sanitizer.test.ts +0 -418
  117. package/test/status.test.ts +0 -10
  118. package/test/subagent-context.test.ts +0 -372
  119. package/test/subagent-lifecycle-events.test.ts +0 -132
  120. package/test/subagent-registry.test.ts +0 -145
  121. package/test/synthesize.test.ts +0 -302
  122. package/test/system-prompt-sanitizer.test.ts +0 -382
  123. package/test/tool-access-extractor-registry.test.ts +0 -77
  124. package/test/tool-input-formatter-registry.test.ts +0 -75
  125. package/test/tool-input-path.test.ts +0 -84
  126. package/test/tool-input-preview.test.ts +0 -129
  127. package/test/tool-input-prompt-formatters.test.ts +0 -115
  128. package/test/tool-preview-formatter.test.ts +0 -458
  129. package/test/tool-registry.test.ts +0 -197
  130. package/test/value-guards.test.ts +0 -193
  131. package/test/wildcard-matcher.test.ts +0 -424
  132. package/test/yaml-frontmatter.test.ts +0 -91
  133. package/test/yolo-mode.test.ts +0 -188
@@ -1,109 +0,0 @@
1
- import { describe, expect, test } from "vitest";
2
-
3
- import {
4
- formatMcpInputForPrompt,
5
- registerBuiltinToolInputFormatters,
6
- } from "#src/builtin-tool-input-formatters";
7
- import { ToolInputFormatterRegistry } from "#src/tool-input-formatter-registry";
8
-
9
- // ── formatMcpInputForPrompt ───────────────────────────────────────────────
10
-
11
- describe("formatMcpInputForPrompt", () => {
12
- test("returns undefined when arguments is absent", () => {
13
- expect(formatMcpInputForPrompt({ tool: "exa:search" })).toBeUndefined();
14
- });
15
-
16
- test("returns undefined when arguments is an empty object", () => {
17
- expect(
18
- formatMcpInputForPrompt({ tool: "exa:search", arguments: {} }),
19
- ).toBeUndefined();
20
- });
21
-
22
- test("returns a summary for a single string argument", () => {
23
- const result = formatMcpInputForPrompt({
24
- tool: "exa:search",
25
- arguments: { query: "typescript generics" },
26
- });
27
- expect(result).toBeDefined();
28
- expect(result).toContain("query");
29
- expect(result).toContain("typescript generics");
30
- expect(result).toMatch(/^with /);
31
- });
32
-
33
- test("returns a comma-separated summary for multiple arguments", () => {
34
- const result = formatMcpInputForPrompt({
35
- tool: "exa:search",
36
- arguments: { query: "test", numResults: 5 },
37
- });
38
- expect(result).toContain("query");
39
- expect(result).toContain("numResults");
40
- expect(result).toContain("5");
41
- });
42
-
43
- test("renders number arguments without quotes", () => {
44
- const result = formatMcpInputForPrompt({
45
- arguments: { count: 42 },
46
- });
47
- expect(result).toContain("42");
48
- expect(result).not.toContain('"42"');
49
- });
50
-
51
- test("renders boolean arguments without quotes", () => {
52
- const result = formatMcpInputForPrompt({
53
- arguments: { verbose: true },
54
- });
55
- expect(result).toContain("true");
56
- });
57
-
58
- test("renders array arguments as '[N items]'", () => {
59
- const result = formatMcpInputForPrompt({
60
- arguments: { ids: [1, 2, 3] },
61
- });
62
- expect(result).toContain("[3 items]");
63
- });
64
-
65
- test("renders nested object arguments as '{…}'", () => {
66
- const result = formatMcpInputForPrompt({
67
- arguments: { filter: { type: "file" } },
68
- });
69
- expect(result).toContain("{…}");
70
- });
71
-
72
- test("truncates the full summary when it exceeds the limit", () => {
73
- // Need multiple long-valued args so the joined summary exceeds 160 chars
74
- const result = formatMcpInputForPrompt({
75
- arguments: {
76
- first: "x".repeat(80),
77
- second: "y".repeat(80),
78
- third: "z".repeat(80),
79
- },
80
- });
81
- expect(result).toBeDefined();
82
- expect(result!.endsWith("…")).toBe(true);
83
- });
84
-
85
- test("truncates long string argument values", () => {
86
- const result = formatMcpInputForPrompt({
87
- arguments: { query: "x".repeat(100) },
88
- });
89
- expect(result).toBeDefined();
90
- // Should not include the full 100-char string verbatim
91
- expect(result).not.toContain("x".repeat(100));
92
- });
93
- });
94
-
95
- // ── registerBuiltinToolInputFormatters ────────────────────────────────────
96
-
97
- describe("registerBuiltinToolInputFormatters", () => {
98
- test("registers the mcp formatter in the registry", () => {
99
- const registry = new ToolInputFormatterRegistry();
100
- registerBuiltinToolInputFormatters(registry);
101
- expect(registry.get("mcp")).toBe(formatMcpInputForPrompt);
102
- });
103
-
104
- test("throws if called twice (duplicate registration guard)", () => {
105
- const registry = new ToolInputFormatterRegistry();
106
- registerBuiltinToolInputFormatters(registry);
107
- expect(() => registerBuiltinToolInputFormatters(registry)).toThrow("mcp");
108
- });
109
- });
@@ -1,119 +0,0 @@
1
- import { beforeEach, describe, expect, test, vi } from "vitest";
2
-
3
- const realpathSync = vi.hoisted(() => vi.fn<(path: string) => string>());
4
-
5
- vi.mock("node:fs", () => ({
6
- realpathSync,
7
- default: { realpathSync },
8
- }));
9
-
10
- import { canonicalizePath } from "#src/canonicalize-path";
11
-
12
- function enoent(p: string): NodeJS.ErrnoException {
13
- return Object.assign(new Error(`ENOENT: no such file or directory '${p}'`), {
14
- code: "ENOENT",
15
- });
16
- }
17
-
18
- describe("canonicalizePath", () => {
19
- beforeEach(() => {
20
- realpathSync.mockReset();
21
- });
22
-
23
- test("returns empty string for empty input", () => {
24
- expect(canonicalizePath("", "linux")).toBe("");
25
- });
26
-
27
- test("returns realpathSync result when path exists", () => {
28
- realpathSync.mockReturnValueOnce("/real/projects/app");
29
- expect(canonicalizePath("/projects/link", "linux")).toBe(
30
- "/real/projects/app",
31
- );
32
- });
33
-
34
- test("re-appends a non-existent leaf to the canonical parent", () => {
35
- realpathSync
36
- .mockImplementationOnce(() => {
37
- throw enoent("/projects/app/new-file.ts");
38
- })
39
- .mockReturnValueOnce("/canonical/app");
40
- expect(canonicalizePath("/projects/app/new-file.ts", "linux")).toBe(
41
- "/canonical/app/new-file.ts",
42
- );
43
- });
44
-
45
- test("walks up multiple levels for a deeply non-existent path", () => {
46
- realpathSync
47
- .mockImplementationOnce(() => {
48
- throw enoent("/projects/app/src/new-file.ts");
49
- })
50
- .mockImplementationOnce(() => {
51
- throw enoent("/projects/app/src");
52
- })
53
- .mockImplementationOnce(() => {
54
- throw enoent("/projects/app");
55
- })
56
- .mockReturnValueOnce("/canonical/projects");
57
- expect(canonicalizePath("/projects/app/src/new-file.ts", "linux")).toBe(
58
- "/canonical/projects/app/src/new-file.ts",
59
- );
60
- });
61
-
62
- test("returns input unchanged when walk reaches filesystem root (all ENOENT)", () => {
63
- realpathSync.mockImplementation(() => {
64
- throw enoent("");
65
- });
66
- expect(canonicalizePath("/nonexistent/path/file.ts", "linux")).toBe(
67
- "/nonexistent/path/file.ts",
68
- );
69
- });
70
-
71
- test("returns input unchanged on ELOOP (symlink loop)", () => {
72
- realpathSync.mockImplementation(() => {
73
- throw Object.assign(new Error("ELOOP"), { code: "ELOOP" });
74
- });
75
- expect(canonicalizePath("/some/looping/path", "linux")).toBe(
76
- "/some/looping/path",
77
- );
78
- });
79
-
80
- test("returns input unchanged on EACCES (permission denied)", () => {
81
- realpathSync.mockImplementation(() => {
82
- throw Object.assign(new Error("EACCES"), { code: "EACCES" });
83
- });
84
- expect(canonicalizePath("/restricted/path", "linux")).toBe(
85
- "/restricted/path",
86
- );
87
- });
88
-
89
- test("handles ENOTDIR by walking up (like ENOENT)", () => {
90
- realpathSync
91
- .mockImplementationOnce(() => {
92
- throw Object.assign(new Error("ENOTDIR"), { code: "ENOTDIR" });
93
- })
94
- .mockReturnValueOnce("/real/parent");
95
- expect(canonicalizePath("/real/parent/not-a-dir", "linux")).toBe(
96
- "/real/parent/not-a-dir",
97
- );
98
- });
99
-
100
- // ── injected platform flavor (win32-separator splitting) ──────────────
101
-
102
- test("win32: splits and rejoins on the backslash separator", () => {
103
- realpathSync
104
- .mockImplementationOnce(() => {
105
- throw enoent("C:\\projects\\link\\file.ts");
106
- })
107
- .mockReturnValueOnce("C:\\real\\app");
108
- expect(canonicalizePath("C:\\projects\\link\\file.ts", "win32")).toBe(
109
- "C:\\real\\app\\file.ts",
110
- );
111
- });
112
-
113
- test("win32: resolves an existing path via realpathSync", () => {
114
- realpathSync.mockReturnValueOnce("C:\\real\\app");
115
- expect(canonicalizePath("C:\\projects\\link", "win32")).toBe(
116
- "C:\\real\\app",
117
- );
118
- });
119
- });