kastell 2.2.5 → 2.2.6

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 (135) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/CHANGELOG.md +19 -0
  4. package/README.md +1 -1
  5. package/dist/commands/fix.d.ts +2 -0
  6. package/dist/commands/fix.d.ts.map +1 -1
  7. package/dist/commands/fix.js +26 -1
  8. package/dist/commands/fix.js.map +1 -1
  9. package/dist/commands/interactive/plugins.d.ts.map +1 -1
  10. package/dist/commands/interactive/plugins.js +26 -2
  11. package/dist/commands/interactive/plugins.js.map +1 -1
  12. package/dist/commands/plugin.d.ts.map +1 -1
  13. package/dist/commands/plugin.js +6 -2
  14. package/dist/commands/plugin.js.map +1 -1
  15. package/dist/core/audit/commands.d.ts +13 -2
  16. package/dist/core/audit/commands.d.ts.map +1 -1
  17. package/dist/core/audit/commands.js +39 -2
  18. package/dist/core/audit/commands.js.map +1 -1
  19. package/dist/core/audit/explainCheck.d.ts +1 -0
  20. package/dist/core/audit/explainCheck.d.ts.map +1 -1
  21. package/dist/core/audit/explainCheck.js +1 -1
  22. package/dist/core/audit/explainCheck.js.map +1 -1
  23. package/dist/core/audit/fix-history.d.ts +3 -1
  24. package/dist/core/audit/fix-history.d.ts.map +1 -1
  25. package/dist/core/audit/fix-history.js +6 -2
  26. package/dist/core/audit/fix-history.js.map +1 -1
  27. package/dist/core/audit/fix.d.ts.map +1 -1
  28. package/dist/core/audit/fix.js +22 -0
  29. package/dist/core/audit/fix.js.map +1 -1
  30. package/dist/core/audit/index.d.ts.map +1 -1
  31. package/dist/core/audit/index.js +12 -3
  32. package/dist/core/audit/index.js.map +1 -1
  33. package/dist/core/audit/listChecks.d.ts.map +1 -1
  34. package/dist/core/audit/listChecks.js +24 -0
  35. package/dist/core/audit/listChecks.js.map +1 -1
  36. package/dist/core/audit/pluginAudit.d.ts +8 -0
  37. package/dist/core/audit/pluginAudit.d.ts.map +1 -0
  38. package/dist/core/audit/pluginAudit.js +134 -0
  39. package/dist/core/audit/pluginAudit.js.map +1 -0
  40. package/dist/core/audit/pluginFix.d.ts +19 -0
  41. package/dist/core/audit/pluginFix.d.ts.map +1 -0
  42. package/dist/core/audit/pluginFix.js +122 -0
  43. package/dist/core/audit/pluginFix.js.map +1 -0
  44. package/dist/core/audit/snapshot.d.ts +4 -4
  45. package/dist/core/audit/types.d.ts +2 -1
  46. package/dist/core/audit/types.d.ts.map +1 -1
  47. package/dist/core/plugin.d.ts +6 -0
  48. package/dist/core/plugin.d.ts.map +1 -1
  49. package/dist/core/plugin.js +2 -0
  50. package/dist/core/plugin.js.map +1 -1
  51. package/dist/index.js +7 -0
  52. package/dist/index.js.map +1 -1
  53. package/dist/mcp/index.js +1 -1
  54. package/dist/mcp/index.js.map +1 -1
  55. package/dist/mcp/pluginTools.d.ts +5 -0
  56. package/dist/mcp/pluginTools.d.ts.map +1 -0
  57. package/dist/mcp/pluginTools.js +54 -0
  58. package/dist/mcp/pluginTools.js.map +1 -0
  59. package/dist/mcp/prompts/workflows.d.ts +17 -0
  60. package/dist/mcp/prompts/workflows.d.ts.map +1 -0
  61. package/dist/mcp/prompts/workflows.js +73 -0
  62. package/dist/mcp/prompts/workflows.js.map +1 -0
  63. package/dist/mcp/resources/checks.d.ts +4 -0
  64. package/dist/mcp/resources/checks.d.ts.map +1 -0
  65. package/dist/mcp/resources/checks.js +49 -0
  66. package/dist/mcp/resources/checks.js.map +1 -0
  67. package/dist/mcp/resources/servers.d.ts +4 -0
  68. package/dist/mcp/resources/servers.d.ts.map +1 -0
  69. package/dist/mcp/resources/servers.js +59 -0
  70. package/dist/mcp/resources/servers.js.map +1 -0
  71. package/dist/mcp/server.d.ts +1 -1
  72. package/dist/mcp/server.d.ts.map +1 -1
  73. package/dist/mcp/server.js +43 -4
  74. package/dist/mcp/server.js.map +1 -1
  75. package/dist/mcp/tools/serverAudit.d.ts +1 -1
  76. package/dist/mcp/tools/serverFix.d.ts.map +1 -1
  77. package/dist/mcp/tools/serverFix.js +7 -1
  78. package/dist/mcp/tools/serverFix.js.map +1 -1
  79. package/dist/mcp/tools/serverManage.d.ts +2 -1
  80. package/dist/mcp/tools/serverManage.d.ts.map +1 -1
  81. package/dist/mcp/tools/serverManage.js +50 -5
  82. package/dist/mcp/tools/serverManage.js.map +1 -1
  83. package/dist/mcp/tools/serverPlugin.d.ts +3 -0
  84. package/dist/mcp/tools/serverPlugin.d.ts.map +1 -1
  85. package/dist/mcp/tools/serverPlugin.js +11 -1
  86. package/dist/mcp/tools/serverPlugin.js.map +1 -1
  87. package/dist/mcp/tools/serverProvision.d.ts +5 -5
  88. package/dist/mcp/tools/serverProvision.d.ts.map +1 -1
  89. package/dist/mcp/tools/serverProvision.js +31 -9
  90. package/dist/mcp/tools/serverProvision.js.map +1 -1
  91. package/dist/mcp/tools/serverSecure.d.ts.map +1 -1
  92. package/dist/mcp/tools/serverSecure.js +30 -1
  93. package/dist/mcp/tools/serverSecure.js.map +1 -1
  94. package/dist/mcp/utils.d.ts +25 -0
  95. package/dist/mcp/utils.d.ts.map +1 -1
  96. package/dist/mcp/utils.js +36 -0
  97. package/dist/mcp/utils.js.map +1 -1
  98. package/dist/mcp-bundle.mjs +47598 -46312
  99. package/dist/plugin/handlerResolver.d.ts +2 -0
  100. package/dist/plugin/handlerResolver.d.ts.map +1 -0
  101. package/dist/plugin/handlerResolver.js +16 -0
  102. package/dist/plugin/handlerResolver.js.map +1 -0
  103. package/dist/plugin/loader.d.ts.map +1 -1
  104. package/dist/plugin/loader.js +41 -4
  105. package/dist/plugin/loader.js.map +1 -1
  106. package/dist/plugin/registerCommands.d.ts +4 -0
  107. package/dist/plugin/registerCommands.d.ts.map +1 -0
  108. package/dist/plugin/registerCommands.js +45 -0
  109. package/dist/plugin/registerCommands.js.map +1 -0
  110. package/dist/plugin/registry.d.ts +20 -1
  111. package/dist/plugin/registry.d.ts.map +1 -1
  112. package/dist/plugin/registry.js +51 -1
  113. package/dist/plugin/registry.js.map +1 -1
  114. package/dist/plugin/sdk/constants.d.ts +2 -0
  115. package/dist/plugin/sdk/constants.d.ts.map +1 -1
  116. package/dist/plugin/sdk/constants.js +2 -0
  117. package/dist/plugin/sdk/constants.js.map +1 -1
  118. package/dist/plugin/sdk/types.d.ts +74 -1
  119. package/dist/plugin/sdk/types.d.ts.map +1 -1
  120. package/dist/plugin/validate.d.ts +2 -1
  121. package/dist/plugin/validate.d.ts.map +1 -1
  122. package/dist/plugin/validate.js +106 -1
  123. package/dist/plugin/validate.js.map +1 -1
  124. package/dist/utils/fileLock.d.ts +5 -1
  125. package/dist/utils/fileLock.d.ts.map +1 -1
  126. package/dist/utils/fileLock.js +70 -15
  127. package/dist/utils/fileLock.js.map +1 -1
  128. package/dist/utils/paths.d.ts +0 -1
  129. package/dist/utils/paths.d.ts.map +1 -1
  130. package/dist/utils/paths.js +1 -2
  131. package/dist/utils/paths.js.map +1 -1
  132. package/dist/utils/secureWrite.d.ts.map +1 -1
  133. package/dist/utils/secureWrite.js +3 -38
  134. package/dist/utils/secureWrite.js.map +1 -1
  135. package/package.json +1 -1
@@ -1,4 +1,8 @@
1
- export declare function withFileLock<T>(filePath: string, fn: () => Promise<T> | T): Promise<T>;
1
+ /** Module-local wrapper for testability DO NOT inline `process.kill`. */
2
+ export declare function probeProcess(pid: number): "alive" | "dead" | "unknown";
3
+ type ProbeFn = (pid: number) => "alive" | "dead" | "unknown";
4
+ export declare function withFileLock<T>(filePath: string, fn: () => Promise<T> | T, probe?: ProbeFn): Promise<T>;
2
5
  /** Warn on stderr if a caught error is a permission issue. Returns true if it was a permission error. */
3
6
  export declare function warnIfPermissionError(err: unknown, label: string): boolean;
7
+ export {};
4
8
  //# sourceMappingURL=fileLock.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"fileLock.d.ts","sourceRoot":"","sources":["../../src/utils/fileLock.ts"],"names":[],"mappings":"AAKA,wBAAsB,YAAY,CAAC,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAyCZ;AAED,yGAAyG;AACzG,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAO1E"}
1
+ {"version":3,"file":"fileLock.d.ts","sourceRoot":"","sources":["../../src/utils/fileLock.ts"],"names":[],"mappings":"AAQA,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAStE;AAoBD,KAAK,OAAO,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAsB7D,wBAAsB,YAAY,CAAC,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACxB,KAAK,GAAE,OAAsB,GAC5B,OAAO,CAAC,CAAC,CAAC,CA+CZ;AAED,yGAAyG;AACzG,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAO1E"}
@@ -1,21 +1,78 @@
1
- import { mkdirSync, rmdirSync, statSync } from "fs";
2
- import { dirname } from "path";
3
- const STALE_THRESHOLD_MS = 30_000; // 30s
4
- export async function withFileLock(filePath, fn) {
1
+ import { mkdirSync, rmSync, statSync, writeFileSync, readFileSync } from "fs";
2
+ import { dirname, join } from "path";
3
+ import { hostname } from "os";
4
+ const STALE_THRESHOLD_MS = 30_000;
5
+ // Reclaim even when probeProcess reports "alive" (guards against clock drift, zombies, PID reuse).
6
+ const HARD_CEILING_MS = 60_000;
7
+ /** Module-local wrapper for testability — DO NOT inline `process.kill`. */
8
+ export function probeProcess(pid) {
9
+ try {
10
+ process.kill(pid, 0);
11
+ return "alive";
12
+ }
13
+ catch (err) {
14
+ const code = err.code;
15
+ if (code === "ESRCH")
16
+ return "dead";
17
+ return "unknown";
18
+ }
19
+ }
20
+ function readPidFile(lockDir) {
21
+ try {
22
+ const raw = readFileSync(join(lockDir, "owner.pid"), "utf-8");
23
+ const parts = raw.split("@");
24
+ if (parts.length !== 3)
25
+ return null;
26
+ const pid = parseInt(parts[0], 10);
27
+ if (isNaN(pid) || pid <= 0)
28
+ return null;
29
+ return { pid, host: parts[1] };
30
+ }
31
+ catch {
32
+ return null;
33
+ }
34
+ }
35
+ function shouldReclaimStaleLock(lockDir, probe) {
36
+ let mtimeMs;
37
+ try {
38
+ mtimeMs = statSync(lockDir).mtimeMs;
39
+ }
40
+ catch {
41
+ return false; // lock disappeared between checks
42
+ }
43
+ const age = Date.now() - mtimeMs;
44
+ const parsed = readPidFile(lockDir);
45
+ if (parsed && parsed.host === hostname()) {
46
+ const liveness = probe(parsed.pid);
47
+ if (liveness === "dead")
48
+ return true;
49
+ if (liveness === "alive")
50
+ return age > HARD_CEILING_MS;
51
+ // "unknown" → mtime fallback (aggressive: STALE_THRESHOLD_MS)
52
+ }
53
+ // farklı hostname, parse fail, PID file yok, veya "unknown" → mtime fallback
54
+ return age > STALE_THRESHOLD_MS;
55
+ }
56
+ export async function withFileLock(filePath, fn, probe = probeProcess) {
5
57
  const lockDir = filePath + ".lock";
6
58
  const maxRetries = 10;
7
59
  const retryDelay = 200;
8
- // Ensure parent directory exists (CI runners may not have ~/.kastell/)
9
60
  mkdirSync(dirname(lockDir), { recursive: true });
10
61
  for (let i = 0; i < maxRetries; i++) {
11
62
  try {
12
63
  mkdirSync(lockDir);
13
64
  try {
65
+ try {
66
+ writeFileSync(join(lockDir, "owner.pid"), `${process.pid}@${hostname()}@${Date.now()}`, { encoding: "utf-8" });
67
+ }
68
+ catch {
69
+ /* best effort — if PID write fails, mtime fallback still protects */
70
+ }
14
71
  return await fn();
15
72
  }
16
73
  finally {
17
74
  try {
18
- rmdirSync(lockDir);
75
+ rmSync(lockDir, { recursive: true, force: true });
19
76
  }
20
77
  catch {
21
78
  /* best effort */
@@ -24,16 +81,14 @@ export async function withFileLock(filePath, fn) {
24
81
  }
25
82
  catch (err) {
26
83
  if (err.code === "EEXIST") {
27
- // Stale lock detection
28
- try {
29
- const stat = statSync(lockDir);
30
- if (Date.now() - stat.mtimeMs > STALE_THRESHOLD_MS) {
31
- rmdirSync(lockDir);
32
- continue;
84
+ if (shouldReclaimStaleLock(lockDir, probe)) {
85
+ try {
86
+ rmSync(lockDir, { recursive: true, force: true });
33
87
  }
34
- }
35
- catch {
36
- /* lock was released between checks */
88
+ catch {
89
+ /* best effort, retry */
90
+ }
91
+ continue;
37
92
  }
38
93
  await new Promise((r) => setTimeout(r, retryDelay));
39
94
  continue;
@@ -1 +1 @@
1
- {"version":3,"file":"fileLock.js","sourceRoot":"","sources":["../../src/utils/fileLock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,kBAAkB,GAAG,MAAM,CAAC,CAAC,MAAM;AAEzC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,EAAwB;IAExB,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnC,MAAM,UAAU,GAAG,EAAE,CAAC;IACtB,MAAM,UAAU,GAAG,GAAG,CAAC;IAEvB,uEAAuE;IACvE,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,SAAS,CAAC,OAAO,CAAC,CAAC;YACnB,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,EAAE,CAAC;YACpB,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC;oBACH,SAAS,CAAC,OAAO,CAAC,CAAC;gBACrB,CAAC;gBAAC,MAAM,CAAC;oBACP,iBAAiB;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,uBAAuB;gBACvB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;oBAC/B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,kBAAkB,EAAE,CAAC;wBACnD,SAAS,CAAC,OAAO,CAAC,CAAC;wBACnB,SAAS;oBACX,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,sCAAsC;gBACxC,CAAC;gBACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;gBACpD,SAAS;YACX,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CACb,6BAA6B,QAAQ,UAAU,UAAU,UAAU,CACpE,CAAC;AACJ,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,qBAAqB,CAAC,GAAY,EAAE,KAAa;IAC/D,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;IACjD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
1
+ {"version":3,"file":"fileLock.js","sourceRoot":"","sources":["../../src/utils/fileLock.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,3 @@
1
- /** Canonical Kastell config directory: ~/.kastell */
2
1
  export declare const KASTELL_DIR: string;
3
2
  /** Backups directory: ~/.kastell/backups */
4
3
  export declare const BACKUPS_DIR: string;
@@ -1 +1 @@
1
- {"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAGA,qDAAqD;AACrD,eAAO,MAAM,WAAW,QAA8B,CAAC;AAEvD,4CAA4C;AAC5C,eAAO,MAAM,WAAW,QAA+B,CAAC;AAExD,kDAAkD;AAClD,eAAO,MAAM,YAAY,QAAoC,CAAC;AAE9D,oDAAoD;AACpD,eAAO,MAAM,WAAW,QAA+B,CAAC;AAExD,2DAA2D;AAC3D,eAAO,MAAM,oBAAoB,QAAoC,CAAC"}
1
+ {"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW,QAAyD,CAAC;AAElF,4CAA4C;AAC5C,eAAO,MAAM,WAAW,QAA+B,CAAC;AAExD,kDAAkD;AAClD,eAAO,MAAM,YAAY,QAAoC,CAAC;AAE9D,oDAAoD;AACpD,eAAO,MAAM,WAAW,QAA+B,CAAC;AAExD,2DAA2D;AAC3D,eAAO,MAAM,oBAAoB,QAAoC,CAAC"}
@@ -1,7 +1,6 @@
1
1
  import { homedir } from "os";
2
2
  import { join } from "path";
3
- /** Canonical Kastell config directory: ~/.kastell */
4
- export const KASTELL_DIR = join(homedir(), ".kastell");
3
+ export const KASTELL_DIR = process.env.KASTELL_DIR || join(homedir(), ".kastell");
5
4
  /** Backups directory: ~/.kastell/backups */
6
5
  export const BACKUPS_DIR = join(KASTELL_DIR, "backups");
7
6
  /** Security audit log: ~/.kastell/security.log */
@@ -1 +1 @@
1
- {"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,qDAAqD;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AAEvD,4CAA4C;AAC5C,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAExD,kDAAkD;AAClD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AAE9D,oDAAoD;AACpD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAExD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC"}
1
+ {"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AAElF,4CAA4C;AAC5C,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAExD,kDAAkD;AAClD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AAE9D,oDAAoD;AACpD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAExD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"secureWrite.d.ts","sourceRoot":"","sources":["../../src/utils/secureWrite.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAUD,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AA8BD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAMrD;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI,CAGN;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,IAAI,CAGN"}
1
+ {"version":3,"file":"secureWrite.d.ts","sourceRoot":"","sources":["../../src/utils/secureWrite.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAOD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAMrD;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI,CAGN;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,IAAI,CAGN"}
@@ -1,47 +1,12 @@
1
- import { spawnSync } from "child_process";
2
1
  import { writeFileSync, mkdirSync, chmodSync } from "fs";
3
- import { userInfo } from "os";
4
- import { SecurityLogger } from "./securityLogger.js";
5
- import { extractReason } from "./errors.js";
6
- let cachedUsername;
7
- function getUsername() {
8
- if (!cachedUsername)
9
- cachedUsername = userInfo().username;
10
- return cachedUsername;
11
- }
12
2
  const securedDirs = new Set();
13
3
  export function clearCache() {
14
4
  securedDirs.clear();
15
- cachedUsername = undefined;
16
5
  }
17
6
  function applyPermissions(targetPath, mode) {
18
- if (process.platform === "win32") {
19
- const result = spawnSync("icacls", [
20
- targetPath,
21
- "/inheritance:r",
22
- "/grant:r",
23
- `${getUsername()}:F`,
24
- ]);
25
- if (result.status !== 0) {
26
- SecurityLogger.warn("ACL operation failed", {
27
- path: targetPath,
28
- platform: process.platform,
29
- error: result.stderr?.toString() ?? "unknown",
30
- });
31
- }
32
- }
33
- else {
34
- try {
35
- chmodSync(targetPath, mode);
36
- }
37
- catch (error) {
38
- SecurityLogger.warn("chmod operation failed", {
39
- path: targetPath,
40
- platform: process.platform,
41
- error: extractReason(error),
42
- });
43
- }
44
- }
7
+ if (process.platform === "win32")
8
+ return; // ACL hardening → v2.4 backlog
9
+ chmodSync(targetPath, mode);
45
10
  }
46
11
  export function ensureSecureDir(dirPath) {
47
12
  if (securedDirs.has(dirPath)) {
@@ -1 +1 @@
1
- {"version":3,"file":"secureWrite.js","sourceRoot":"","sources":["../../src/utils/secureWrite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO5C,IAAI,cAAkC,CAAC;AACvC,SAAS,WAAW;IAClB,IAAI,CAAC,cAAc;QAAE,cAAc,GAAG,QAAQ,EAAE,CAAC,QAAQ,CAAC;IAC1D,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;AAEtC,MAAM,UAAU,UAAU;IACxB,WAAW,CAAC,KAAK,EAAE,CAAC;IACpB,cAAc,GAAG,SAAS,CAAC;AAC7B,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAkB,EAAE,IAAmB;IAC/D,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE;YACjC,UAAU;YACV,gBAAgB;YAChB,UAAU;YACV,GAAG,WAAW,EAAE,IAAI;SACrB,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,cAAc,CAAC,IAAI,CAAC,sBAAsB,EAAE;gBAC1C,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,SAAS;aAC9C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,cAAc,CAAC,IAAI,CAAC,wBAAwB,EAAE;gBAC5C,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC;aAC5B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IACD,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACjC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,IAAY,EACZ,OAA0B;IAE1B,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,OAAiC;IAEjC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,EAAE,CAAC,CAAC;IAC9D,eAAe,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC"}
1
+ {"version":3,"file":"secureWrite.js","sourceRoot":"","sources":["../../src/utils/secureWrite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAOzD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;AAEtC,MAAM,UAAU,UAAU;IACxB,WAAW,CAAC,KAAK,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAkB,EAAE,IAAmB;IAC/D,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,CAAC,+BAA+B;IACzE,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IACD,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACjC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,IAAY,EACZ,OAA0B;IAE1B,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,OAAiC;IAEjC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,EAAE,CAAC,CAAC;IAC9D,eAAe,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "kastell",
3
- "version": "2.2.5",
3
+ "version": "2.2.6",
4
4
  "description": "CLI toolkit for provisioning, securing, and managing self-hosted servers",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",