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
@@ -0,0 +1,2 @@
1
+ export declare function resolvePluginHandler(pluginDir: string, handlerPath: string): Promise<(...args: unknown[]) => unknown>;
2
+ //# sourceMappingURL=handlerResolver.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"handlerResolver.d.ts","sourceRoot":"","sources":["../../src/plugin/handlerResolver.ts"],"names":[],"mappings":"AAIA,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAa1C"}
@@ -0,0 +1,16 @@
1
+ import { resolve } from "path";
2
+ import { pathToFileURL } from "url";
3
+ export async function resolvePluginHandler(pluginDir, handlerPath) {
4
+ const absPath = resolve(pluginDir, handlerPath);
5
+ const url = pathToFileURL(absPath).href;
6
+ const mod = (await import(url));
7
+ const handler = (typeof mod.default === "function" ? mod.default : mod.default?.handler) ??
8
+ mod.handler ??
9
+ mod.fix ??
10
+ mod.run;
11
+ if (typeof handler !== "function") {
12
+ throw new Error(`Plugin handler not found: ${handlerPath}`);
13
+ }
14
+ return handler;
15
+ }
16
+ //# sourceMappingURL=handlerResolver.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"handlerResolver.js","sourceRoot":"","sources":["../../src/plugin/handlerResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAGpC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAiB,EACjB,WAAmB;IAEnB,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IACxC,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,CAAuB,CAAC;IACtD,MAAM,OAAO,GACX,CAAC,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC;QACxE,GAAG,CAAC,OAAO;QACX,GAAG,CAAC,GAAG;QACP,GAAG,CAAC,GAAG,CAAC;IACV,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,6BAA6B,WAAW,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,OAA0C,CAAC;AACpD,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugin/loader.ts"],"names":[],"mappings":"AAiBA,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/C;AAED,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAsB,WAAW,CAC/B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAsG5B"}
1
+ {"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugin/loader.ts"],"names":[],"mappings":"AAiBA,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/C;AAED,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAsB,WAAW,CAC/B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAoJ5B"}
@@ -3,7 +3,7 @@ import { existsSync, readdirSync, readFileSync } from "fs";
3
3
  import { join, resolve, sep } from "path";
4
4
  import { pathToFileURL } from "url";
5
5
  import { PLUGINS_NODE_MODULES } from "../utils/paths.js";
6
- import { validateManifest } from "./validate.js";
6
+ import { validateManifest, validateChecks } from "./validate.js";
7
7
  import { extractReason } from "../utils/errors.js";
8
8
  import { registerPlugin, registerFailedPlugin, clearPluginRegistry, mapRegistryPlugins, savePluginCache, } from "./registry.js";
9
9
  export async function loadPlugins(options) {
@@ -64,13 +64,50 @@ export async function loadPlugins(options) {
64
64
  registerFailedPlugin(manifest, msg);
65
65
  throw new Error(`${dir.name}: import failed — ${msg}`, { cause: err });
66
66
  }
67
- const moduleObj = mod;
67
+ const ns = mod;
68
+ // ESM CJS interop: namespace has .default = module.exports, plus .module.exports = module.exports
69
+ const moduleObj = (ns.default ?? ns["module.exports"] ?? ns);
68
70
  if (!Array.isArray(moduleObj.checks)) {
69
71
  registerFailedPlugin(manifest, "module does not export checks array");
70
72
  throw new Error(`${dir.name}: module does not export checks array`);
71
73
  }
72
- const checks = moduleObj.checks;
73
- registerPlugin(manifest, checks);
74
+ let checks;
75
+ try {
76
+ checks = validateChecks(moduleObj.checks, manifest.checkPrefix);
77
+ }
78
+ catch (err) {
79
+ const msg = extractReason(err);
80
+ registerFailedPlugin(manifest, msg);
81
+ throw new Error(`${dir.name}: check validation failed — ${msg}`, { cause: err });
82
+ }
83
+ const enrichedManifest = {
84
+ ...manifest,
85
+ commands: moduleObj.commands ?? manifest.commands,
86
+ mcpTools: moduleObj.mcpTools ?? manifest.mcpTools,
87
+ fixes: moduleObj.fixes ?? manifest.fixes,
88
+ };
89
+ function guardHandlerPath(pluginDir, handler, type) {
90
+ const resolved = resolve(pluginDir, handler);
91
+ if (!resolved.startsWith(pluginDir + sep) && resolved !== pluginDir) {
92
+ throw new Error(`${type} handler escapes plugin directory: ${handler}`);
93
+ }
94
+ }
95
+ if (enrichedManifest.fixes) {
96
+ for (const fix of enrichedManifest.fixes) {
97
+ guardHandlerPath(resolvedDir, fix.handler, "fix");
98
+ }
99
+ }
100
+ if (enrichedManifest.commands) {
101
+ for (const cmd of enrichedManifest.commands) {
102
+ guardHandlerPath(resolvedDir, cmd.handler, "command");
103
+ }
104
+ }
105
+ if (enrichedManifest.mcpTools) {
106
+ for (const tool of enrichedManifest.mcpTools) {
107
+ guardHandlerPath(resolvedDir, tool.handler, "mcpTool");
108
+ }
109
+ }
110
+ registerPlugin(enrichedManifest, checks);
74
111
  return manifest.name;
75
112
  }));
76
113
  for (const result of results) {
@@ -1 +1 @@
1
- {"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/plugin/loader.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/plugin/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC;AAavB,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAA4B;IAE5B,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,mBAAmB,EAAE,CAAC;IAEtB,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,oBAAoB,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAC/B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAC/D,CAAC;IAEF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;QAE5D,MAAM,cAAc,GAAG,GAAmB,EAAE,CAAC,CAAC;YAC5C,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,OAAO;YAChB,UAAU,EAAE,GAAG;YACf,OAAO,EAAE,GAAG;YACZ,YAAY,EAAE,CAAC,OAAO,CAAC;YACvB,WAAW,EAAE,oBAAoB;YACjC,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;QAEH,IAAI,WAAmB,CAAC;QACxB,IAAI,CAAC;YACH,WAAW,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,oBAAoB,CAAC,cAAc,EAAE,EAAE,iCAAiC,CAAC,CAAC;YAC1E,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,mCAAmC,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,cAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,oBAAoB,CAAC,cAAc,EAAE,EAAE,qCAAqC,CAAC,CAAC;YAC9E,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,uCAAuC,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,QAAQ,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC;QAElD,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC3D,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,WAAW,GAAG,GAAG,CAAC,IAAI,aAAa,KAAK,WAAW,EAAE,CAAC;YAClF,oBAAoB,CAAC,QAAQ,EAAE,mCAAmC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;YACpF,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,qCAAqC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,QAAQ,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC;QAEnD,IAAI,GAAY,CAAC;QACjB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;YAC/B,oBAAoB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,qBAAqB,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,EAAE,GAAG,GAA8B,CAAC;QAC1C,kGAAkG;QAClG,MAAM,SAAS,GAAG,CAAC,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAA4B,CAAC;QACxF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,oBAAoB,CAClB,QAAQ,EACR,qCAAqC,CACtC,CAAC;YACF,MAAM,IAAI,KAAK,CACb,GAAG,GAAG,CAAC,IAAI,uCAAuC,CACnD,CAAC;QACJ,CAAC;QAED,IAAI,MAAqB,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;YAC/B,oBAAoB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,+BAA+B,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACnF,CAAC;QAED,MAAM,gBAAgB,GAAmB;YACvC,GAAG,QAAQ;YACX,QAAQ,EAAG,SAAS,CAAC,QAAwC,IAAI,QAAQ,CAAC,QAAQ;YAClF,QAAQ,EAAG,SAAS,CAAC,QAAwC,IAAI,QAAQ,CAAC,QAAQ;YAClF,KAAK,EAAG,SAAS,CAAC,KAAiC,IAAI,QAAQ,CAAC,KAAK;SACtE,CAAC;QAEF,SAAS,gBAAgB,CACvB,SAAiB,EACjB,OAAe,EACf,IAAY;YAEZ,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC7C,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,GAAG,GAAG,CAAC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACpE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,sCAAsC,OAAO,EAAE,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,IAAI,gBAAgB,CAAC,KAAK,EAAE,CAAC;YAC3B,KAAK,MAAM,GAAG,IAAI,gBAAgB,CAAC,KAAK,EAAE,CAAC;gBACzC,gBAAgB,CAAC,WAAW,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAED,IAAI,gBAAgB,CAAC,QAAQ,EAAE,CAAC;YAC9B,KAAK,MAAM,GAAG,IAAI,gBAAgB,CAAC,QAAQ,EAAE,CAAC;gBAC5C,gBAAgB,CAAC,WAAW,EAAE,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,IAAI,gBAAgB,CAAC,QAAQ,EAAE,CAAC;YAC9B,KAAK,MAAM,IAAI,IAAI,gBAAgB,CAAC,QAAQ,EAAE,CAAC;gBAC7C,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAED,cAAc,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;QACzC,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC,CAAC,CACH,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAChD,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAClD,CAAC,MAAM,CAAC,CAAC,CAAC,EAAuB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IACjD,eAAe,CAAC,SAAS,CAAC,CAAC;IAE3B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { Command } from "commander";
2
+ import type { PluginCommandEntry } from "./registry.js";
3
+ export declare function registerPluginCommands(program: Command, entries: PluginCommandEntry[]): number;
4
+ //# sourceMappingURL=registerCommands.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registerCommands.d.ts","sourceRoot":"","sources":["../../src/plugin/registerCommands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAIxD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,kBAAkB,EAAE,GAC5B,MAAM,CA8CR"}
@@ -0,0 +1,45 @@
1
+ import { debugLog } from "../utils/logger.js";
2
+ import { resolvePluginHandler } from "./handlerResolver.js";
3
+ export function registerPluginCommands(program, entries) {
4
+ if (entries.length === 0)
5
+ return 0;
6
+ // Dynamic collision check — no static list needed, program.commands is authoritative
7
+ const existingNames = new Set(program.commands.map(c => c.name()));
8
+ const grouped = new Map();
9
+ for (const entry of entries) {
10
+ const group = grouped.get(entry.pluginShortName) ?? [];
11
+ group.push(entry);
12
+ grouped.set(entry.pluginShortName, group);
13
+ }
14
+ let count = 0;
15
+ for (const [shortName, cmds] of grouped) {
16
+ if (existingNames.has(shortName)) {
17
+ debugLog?.(`plugin command "${shortName}" collides with built-in command, skipping`);
18
+ continue;
19
+ }
20
+ const pluginCmd = program
21
+ .command(shortName)
22
+ .description(`[plugin] ${cmds[0].pluginShortName} commands`);
23
+ for (const entry of cmds) {
24
+ pluginCmd
25
+ .command(entry.command.name)
26
+ .description(entry.command.description)
27
+ .action(async (...args) => {
28
+ const handler = await resolvePluginHandler(entry.pluginDir, entry.command.handler);
29
+ await handler(args[args.length - 1] ?? {}, {
30
+ logger: {
31
+ info: (msg) => console.log(msg),
32
+ warn: (msg) => console.warn(msg),
33
+ error: (msg) => console.error(msg),
34
+ },
35
+ ssh: async () => {
36
+ throw new Error("SSH not available in CLI plugin context — use kastell audit/fix for SSH operations");
37
+ },
38
+ });
39
+ });
40
+ count++;
41
+ }
42
+ }
43
+ return count;
44
+ }
45
+ //# sourceMappingURL=registerCommands.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registerCommands.js","sourceRoot":"","sources":["../../src/plugin/registerCommands.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,UAAU,sBAAsB,CACpC,OAAgB,EAChB,OAA6B;IAE7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEnC,qFAAqF;IACrF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;IAExD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;QACxC,IAAI,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,QAAQ,EAAE,CAAC,mBAAmB,SAAS,4CAA4C,CAAC,CAAC;YACrF,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,OAAO;aACtB,OAAO,CAAC,SAAS,CAAC;aAClB,WAAW,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,WAAW,CAAC,CAAC;QAE/D,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;YACzB,SAAS;iBACN,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;iBAC3B,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;iBACtC,MAAM,CAAC,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;gBACnC,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACnF,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;oBACzC,MAAM,EAAE;wBACN,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;wBACvC,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;wBACxC,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;qBAC3C;oBACD,GAAG,EAAE,KAAK,IAAI,EAAE;wBACd,MAAM,IAAI,KAAK,CAAC,oFAAoF,CAAC,CAAC;oBACxG,CAAC;iBACF,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACL,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}
@@ -1,14 +1,33 @@
1
- import type { PluginManifest, PluginCheck } from "./sdk/types.js";
1
+ import type { PluginManifest, PluginCheck, PluginCommand, PluginMcpTool, PluginFix } from "./sdk/types.js";
2
2
  export interface PluginRegistryEntry {
3
3
  manifest: PluginManifest;
4
4
  checks: PluginCheck[];
5
5
  status: "loaded" | "failed";
6
6
  reason?: string;
7
+ commands?: PluginCommand[];
8
+ mcpTools?: PluginMcpTool[];
9
+ fixes?: PluginFix[];
10
+ checksById: ReadonlyMap<string, PluginCheck>;
11
+ fixesByCheckId: ReadonlyMap<string, PluginFix>;
7
12
  }
8
13
  export declare function registerPlugin(manifest: PluginManifest, checks: PluginCheck[]): void;
9
14
  export declare function registerFailedPlugin(manifest: PluginManifest, reason: string): void;
10
15
  export declare function deletePlugin(name: string): void;
11
16
  export declare function mapRegistryPlugins<T>(callback: (name: string, entry: PluginRegistryEntry) => T): T[];
17
+ export interface PluginCommandEntry {
18
+ pluginShortName: string;
19
+ command: PluginCommand;
20
+ pluginDir: string;
21
+ }
22
+ export interface PluginMcpToolEntry {
23
+ pluginShortName: string;
24
+ toolName: string;
25
+ tool: PluginMcpTool;
26
+ pluginDir: string;
27
+ }
28
+ export declare function getShortName(pluginName: string): string;
29
+ export declare function getPluginCommands(): PluginCommandEntry[];
30
+ export declare function getPluginMcpTools(): PluginMcpToolEntry[];
12
31
  export declare function clearPluginRegistry(): void;
13
32
  export declare function getPluginRegistry(): ReadonlyMap<string, PluginRegistryEntry>;
14
33
  export declare function loadPluginCache(): PluginManifest[];
@@ -1 +1 @@
1
- {"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugin/registry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAKlE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,WAAW,EAAE,GACpB,IAAI,CAqCN;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,GACb,IAAI,CAON;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAS/C;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,KAAK,CAAC,GACxD,CAAC,EAAE,CAML;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAE5E;AAED,wBAAgB,eAAe,IAAI,cAAc,EAAE,CAalD;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,IAAI,CAYjE"}
1
+ {"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugin/registry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAM3G,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC7C,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAChD;AAMD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,WAAW,EAAE,GACpB,IAAI,CAkDN;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,GACb,IAAI,CASN;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAS/C;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,KAAK,CAAC,GACxD,CAAC,EAAE,CAML;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,iBAAiB,IAAI,kBAAkB,EAAE,CAWxD;AAED,wBAAgB,iBAAiB,IAAI,kBAAkB,EAAE,CAgBxD;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAE5E;AAED,wBAAgB,eAAe,IAAI,cAAc,EAAE,CAalD;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,IAAI,CAYjE"}
@@ -2,8 +2,9 @@ import { readFileSync, existsSync } from "fs";
2
2
  import { join } from "path";
3
3
  import { ValidationError } from "../utils/errors.js";
4
4
  import { secureWriteFileSync, secureMkdirSync } from "../utils/secureWrite.js";
5
- import { KASTELL_DIR } from "../utils/paths.js";
5
+ import { KASTELL_DIR, PLUGINS_NODE_MODULES } from "../utils/paths.js";
6
6
  import { debugLog } from "../utils/logger.js";
7
+ import { PLUGIN_NAME_PREFIX, PLUGIN_TOOL_PREFIX } from "./sdk/constants.js";
7
8
  const PLUGIN_CACHE_PATH = join(KASTELL_DIR, "plugin-manifests.json");
8
9
  const PLUGIN_REGISTRY = new Map();
9
10
  const usedPrefixes = new Map();
@@ -28,10 +29,23 @@ export function registerPlugin(manifest, checks) {
28
29
  for (const check of checks) {
29
30
  usedCheckIds.add(check.id);
30
31
  }
32
+ const checksById = new Map();
33
+ for (const check of checks)
34
+ checksById.set(check.id, check);
35
+ const fixesByCheckId = new Map();
36
+ if (manifest.fixes) {
37
+ for (const fix of manifest.fixes)
38
+ fixesByCheckId.set(fix.checkId, fix);
39
+ }
31
40
  PLUGIN_REGISTRY.set(manifest.name, {
32
41
  manifest,
33
42
  checks,
34
43
  status: "loaded",
44
+ commands: manifest.commands,
45
+ mcpTools: manifest.mcpTools,
46
+ fixes: manifest.fixes,
47
+ checksById,
48
+ fixesByCheckId,
35
49
  });
36
50
  }
37
51
  export function registerFailedPlugin(manifest, reason) {
@@ -40,6 +54,8 @@ export function registerFailedPlugin(manifest, reason) {
40
54
  checks: [],
41
55
  status: "failed",
42
56
  reason,
57
+ checksById: new Map(),
58
+ fixesByCheckId: new Map(),
43
59
  });
44
60
  }
45
61
  export function deletePlugin(name) {
@@ -59,6 +75,40 @@ export function mapRegistryPlugins(callback) {
59
75
  }
60
76
  return results;
61
77
  }
78
+ export function getShortName(pluginName) {
79
+ return pluginName.replace(PLUGIN_NAME_PREFIX, "");
80
+ }
81
+ export function getPluginCommands() {
82
+ const entries = [];
83
+ for (const [, entry] of PLUGIN_REGISTRY) {
84
+ if (entry.status !== "loaded" || !entry.commands?.length)
85
+ continue;
86
+ const shortName = getShortName(entry.manifest.name);
87
+ const pluginDir = join(PLUGINS_NODE_MODULES, entry.manifest.name);
88
+ for (const cmd of entry.commands) {
89
+ entries.push({ pluginShortName: shortName, command: cmd, pluginDir });
90
+ }
91
+ }
92
+ return entries;
93
+ }
94
+ export function getPluginMcpTools() {
95
+ const entries = [];
96
+ for (const [, entry] of PLUGIN_REGISTRY) {
97
+ if (entry.status !== "loaded" || !entry.mcpTools?.length)
98
+ continue;
99
+ const shortName = getShortName(entry.manifest.name);
100
+ const pluginDir = join(PLUGINS_NODE_MODULES, entry.manifest.name);
101
+ for (const tool of entry.mcpTools) {
102
+ entries.push({
103
+ pluginShortName: shortName,
104
+ toolName: `${PLUGIN_TOOL_PREFIX}${shortName}_${tool.name}`,
105
+ tool,
106
+ pluginDir,
107
+ });
108
+ }
109
+ }
110
+ return entries;
111
+ }
62
112
  export function clearPluginRegistry() {
63
113
  PLUGIN_REGISTRY.clear();
64
114
  usedPrefixes.clear();
@@ -1 +1 @@
1
- {"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/plugin/registry.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/plugin/registry.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,5 @@
1
1
  export declare const PLUGIN_NAME_PATTERN: RegExp;
2
2
  export declare const FAILED_PLUGIN_PREFIX = "ERR";
3
+ export declare const PLUGIN_NAME_PREFIX = "kastell-plugin-";
4
+ export declare const PLUGIN_TOOL_PREFIX = "server_plugin_";
3
5
  //# sourceMappingURL=constants.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/plugin/sdk/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,QAAgC,CAAC;AACjE,eAAO,MAAM,oBAAoB,QAAQ,CAAC"}
1
+ {"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/plugin/sdk/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,QAAgC,CAAC;AACjE,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAC1C,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AACpD,eAAO,MAAM,kBAAkB,mBAAmB,CAAC"}
@@ -1,3 +1,5 @@
1
1
  export const PLUGIN_NAME_PATTERN = /^kastell-plugin-[a-z0-9-]+$/;
2
2
  export const FAILED_PLUGIN_PREFIX = "ERR";
3
+ export const PLUGIN_NAME_PREFIX = "kastell-plugin-";
4
+ export const PLUGIN_TOOL_PREFIX = "server_plugin_";
3
5
  //# sourceMappingURL=constants.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/plugin/sdk/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,6BAA6B,CAAC;AACjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC"}
1
+ {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/plugin/sdk/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,6BAA6B,CAAC;AACjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAC1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC"}
@@ -1,13 +1,57 @@
1
+ export type PluginCapability = "audit" | "command" | "mcp-tool" | "fix";
1
2
  export type PluginSeverity = "critical" | "warning" | "info";
2
3
  export type PluginFixTier = "SAFE" | "GUARDED" | "FORBIDDEN";
4
+ export interface PluginCommand {
5
+ name: string;
6
+ description: string;
7
+ handler: string;
8
+ }
9
+ export interface PluginMcpTool {
10
+ name: string;
11
+ description: string;
12
+ handler: string;
13
+ inputSchema?: Record<string, unknown>;
14
+ }
15
+ export interface PluginContext {
16
+ server?: string;
17
+ ip?: string;
18
+ ssh: (command: string, options?: {
19
+ timeoutMs?: number;
20
+ }) => Promise<{
21
+ stdout: string;
22
+ stderr: string;
23
+ code: number;
24
+ }>;
25
+ logger: {
26
+ info: (msg: string) => void;
27
+ warn: (msg: string) => void;
28
+ error: (msg: string) => void;
29
+ };
30
+ }
31
+ export type PluginCommandHandler = (args: Record<string, unknown>, ctx: PluginContext) => Promise<void>;
32
+ export type PluginMcpToolHandler = (args: Record<string, unknown>, ctx: PluginContext) => Promise<{
33
+ content: Array<{
34
+ type: string;
35
+ text: string;
36
+ }>;
37
+ }>;
38
+ export interface PluginFix {
39
+ checkId: string;
40
+ tier: "SAFE" | "GUARDED";
41
+ handler: string;
42
+ backupPaths?: string[];
43
+ }
3
44
  export interface PluginManifest {
4
45
  name: string;
5
46
  version: string;
6
47
  apiVersion: string;
7
48
  kastell: string;
8
- capabilities: Array<"audit">;
49
+ capabilities: PluginCapability[];
9
50
  checkPrefix: string;
10
51
  entry: string;
52
+ commands?: PluginCommand[];
53
+ mcpTools?: PluginMcpTool[];
54
+ fixes?: PluginFix[];
11
55
  }
12
56
  export interface PluginCheck {
13
57
  id: string;
@@ -26,4 +70,33 @@ export interface PluginCheck {
26
70
  ref: string;
27
71
  }>;
28
72
  }
73
+ export interface PluginFixContext {
74
+ ip: string;
75
+ ssh: (command: string, options?: {
76
+ timeoutMs?: number;
77
+ }) => Promise<{
78
+ stdout: string;
79
+ stderr: string;
80
+ code: number;
81
+ }>;
82
+ logger: {
83
+ info: (msg: string) => void;
84
+ warn: (msg: string) => void;
85
+ error: (msg: string) => void;
86
+ };
87
+ dryRun: boolean;
88
+ manifest: PluginManifest;
89
+ }
90
+ export interface PluginFixResult {
91
+ success: boolean;
92
+ error?: string;
93
+ modifiedFiles?: string[];
94
+ }
95
+ export type PluginFixHandler = (checkId: string, ctx: PluginFixContext) => Promise<PluginFixResult>;
96
+ export interface PluginModuleExport {
97
+ default?: Record<string, unknown> | ((...args: unknown[]) => unknown);
98
+ handler?: (...args: unknown[]) => unknown;
99
+ run?: (...args: unknown[]) => unknown;
100
+ fix?: (...args: unknown[]) => unknown;
101
+ }
29
102
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugin/sdk/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugin/sdk/types.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,4 @@
1
- import type { PluginManifest } from "./sdk/types.js";
1
+ import type { PluginManifest, PluginCheck } from "./sdk/types.js";
2
2
  export declare function validateManifest(manifest: unknown): PluginManifest;
3
+ export declare function validateChecks(checks: unknown, checkPrefix: string): PluginCheck[];
3
4
  //# sourceMappingURL=validate.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/plugin/validate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAerD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,cAAc,CAoBlE"}
1
+ {"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/plugin/validate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAoElE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,cAAc,CA6DlE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAwBlF"}
@@ -3,15 +3,63 @@ import semver from "semver";
3
3
  import { ValidationError } from "../utils/errors.js";
4
4
  import { KASTELL_VERSION } from "../utils/version.js";
5
5
  import { PLUGIN_NAME_PATTERN } from "./sdk/constants.js";
6
+ const HANDLER_PATH_PATTERN = /^\.\/(?!.*\.\.)(?:[a-zA-Z0-9_-]+\/)*[a-zA-Z0-9_-]+\.js$/;
7
+ const PluginCommandSchema = z.object({
8
+ name: z.string().min(1),
9
+ description: z.string().min(1),
10
+ handler: z.string().regex(HANDLER_PATH_PATTERN, "Handler must be relative ./path.js"),
11
+ });
12
+ const PluginMcpToolSchema = z.object({
13
+ name: z.string().min(1),
14
+ description: z.string().min(1),
15
+ handler: z.string().regex(HANDLER_PATH_PATTERN, "Handler must be relative ./path.js"),
16
+ });
17
+ const PluginFixSchema = z.object({
18
+ checkId: z.string().min(1),
19
+ tier: z.enum(["SAFE", "GUARDED"]),
20
+ handler: z.string().regex(HANDLER_PATH_PATTERN, "Handler must be relative ./path.js"),
21
+ backupPaths: z.array(z.string().regex(/^\//, "Backup path must be absolute")).optional(),
22
+ });
23
+ const PluginCheckSchema = z.object({
24
+ id: z
25
+ .string()
26
+ .regex(/^[A-Z][A-Z0-9_-]{1,63}$/, "Check id must be uppercase alphanumeric/underscore/dash, 2-64 chars"),
27
+ category: z.string().min(1),
28
+ name: z.string().min(1),
29
+ severity: z.enum(["critical", "warning", "info"]),
30
+ description: z.string().optional(),
31
+ checkCommand: z
32
+ .string()
33
+ .min(1)
34
+ .refine((s) => !s.includes("---SECTION:"), "checkCommand must not contain '---SECTION:' substring")
35
+ .refine((s) => !s.includes("KASTELL_PLUGIN_CHECK_EOF"), "checkCommand must not contain heredoc tag 'KASTELL_PLUGIN_CHECK_EOF'")
36
+ .refine((s) => !/\r/.test(s), "checkCommand must not contain CR characters"),
37
+ passPattern: z.string().optional(),
38
+ failPattern: z.string().optional(),
39
+ fixCommand: z.string().optional(),
40
+ safeToAutoFix: z.enum(["SAFE", "GUARDED", "FORBIDDEN"]).optional(),
41
+ explain: z
42
+ .union([
43
+ z.string(),
44
+ z.object({ why: z.string(), fix: z.string() }),
45
+ ])
46
+ .optional(),
47
+ complianceRefs: z
48
+ .array(z.object({ framework: z.string(), ref: z.string() }))
49
+ .optional(),
50
+ });
6
51
  const PluginManifestSchema = z
7
52
  .object({
8
53
  name: z.string().regex(PLUGIN_NAME_PATTERN, "Name must match kastell-plugin-<lowercase>"),
9
54
  version: z.string().regex(/^\d+\.\d+\.\d+$/, "Version must be semver (X.Y.Z)"),
10
55
  apiVersion: z.literal("1"),
11
56
  kastell: z.string().min(1, "Kastell version range required"),
12
- capabilities: z.tuple([z.literal("audit")]),
57
+ capabilities: z.array(z.enum(["audit", "command", "mcp-tool", "fix"])).min(1),
13
58
  checkPrefix: z.string().regex(/^[A-Z]{2,6}$/, "checkPrefix must be 2-6 uppercase letters"),
14
59
  entry: z.string().min(1, "Entry point required"),
60
+ commands: z.array(PluginCommandSchema).optional(),
61
+ mcpTools: z.array(PluginMcpToolSchema).optional(),
62
+ fixes: z.array(PluginFixSchema).optional(),
15
63
  })
16
64
  .strict();
17
65
  export function validateManifest(manifest) {
@@ -26,6 +74,63 @@ export function validateManifest(manifest) {
26
74
  if (!semver.satisfies(KASTELL_VERSION, parsed.data.kastell)) {
27
75
  throw new ValidationError(`Plugin requires Kastell ${parsed.data.kastell}, current: ${KASTELL_VERSION}`);
28
76
  }
77
+ if (parsed.data.fixes) {
78
+ for (const fix of parsed.data.fixes) {
79
+ if (!fix.checkId.startsWith(parsed.data.checkPrefix + "-")) {
80
+ throw new ValidationError(`Fix checkId "${fix.checkId}" must start with plugin prefix "${parsed.data.checkPrefix}-"`);
81
+ }
82
+ }
83
+ }
84
+ if (parsed.data.commands) {
85
+ const names = parsed.data.commands.map((c) => c.name);
86
+ if (names.length !== new Set(names).size) {
87
+ throw new ValidationError("Duplicate command names are not allowed");
88
+ }
89
+ }
90
+ if (parsed.data.mcpTools) {
91
+ const names = parsed.data.mcpTools.map((m) => m.name);
92
+ if (names.length !== new Set(names).size) {
93
+ throw new ValidationError("Duplicate mcpTool names are not allowed");
94
+ }
95
+ }
96
+ if (parsed.data.fixes) {
97
+ const checkIds = parsed.data.fixes.map((f) => f.checkId);
98
+ if (checkIds.length !== new Set(checkIds).size) {
99
+ throw new ValidationError("Duplicate fix checkIds are not allowed");
100
+ }
101
+ }
102
+ if (parsed.data.commands && !parsed.data.capabilities.includes("command")) {
103
+ throw new ValidationError("commands field requires 'command' capability");
104
+ }
105
+ if (parsed.data.mcpTools && !parsed.data.capabilities.includes("mcp-tool")) {
106
+ throw new ValidationError("mcpTools field requires 'mcp-tool' capability");
107
+ }
108
+ if (parsed.data.fixes && !parsed.data.capabilities.includes("fix")) {
109
+ throw new ValidationError("fixes field requires 'fix' capability");
110
+ }
29
111
  return parsed.data;
30
112
  }
113
+ export function validateChecks(checks, checkPrefix) {
114
+ if (!Array.isArray(checks)) {
115
+ throw new ValidationError("Plugin checks must be an array");
116
+ }
117
+ const parsed = [];
118
+ const seen = new Set();
119
+ for (let i = 0; i < checks.length; i++) {
120
+ const result = PluginCheckSchema.safeParse(checks[i]);
121
+ if (!result.success) {
122
+ throw new ValidationError(`Invalid plugin check at index ${i}: ${result.error.message}`);
123
+ }
124
+ const check = result.data;
125
+ if (!check.id.startsWith(checkPrefix + "-")) {
126
+ throw new ValidationError(`Check id "${check.id}" must start with plugin prefix "${checkPrefix}-"`);
127
+ }
128
+ if (seen.has(check.id)) {
129
+ throw new ValidationError(`Duplicate check id "${check.id}" within plugin`);
130
+ }
131
+ seen.add(check.id);
132
+ parsed.push(check);
133
+ }
134
+ return parsed;
135
+ }
31
136
  //# sourceMappingURL=validate.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/plugin/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,oBAAoB,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,4CAA4C,CAAC;IACzF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE,gCAAgC,CAAC;IAC9E,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;IAC5D,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,2CAA2C,CAAC;IAC1F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,sBAAsB,CAAC;CACjD,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,UAAU,gBAAgB,CAAC,QAAiB;IAChD,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,eAAe,CAAC,4BAA4B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CACvB,mCAAmC,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,CAC1D,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,eAAe,CACvB,2BAA2B,MAAM,CAAC,IAAI,CAAC,OAAO,cAAc,eAAe,EAAE,CAC9E,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}
1
+ {"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/plugin/validate.ts"],"names":[],"mappings":"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"}