kastell 2.2.6 → 2.3.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.
- package/.claude-plugin/plugin.json +5 -3
- package/CHANGELOG.md +112 -0
- package/README.md +34 -6
- package/README.tr.md +6 -6
- package/dist/commands/audit.d.ts +3 -2
- package/dist/commands/audit.d.ts.map +1 -1
- package/dist/commands/audit.js +88 -47
- package/dist/commands/audit.js.map +1 -1
- package/dist/commands/auth.d.ts.map +1 -1
- package/dist/commands/auth.js +14 -1
- package/dist/commands/auth.js.map +1 -1
- package/dist/commands/domain.d.ts.map +1 -1
- package/dist/commands/domain.js +18 -1
- package/dist/commands/domain.js.map +1 -1
- package/dist/commands/evidence.d.ts.map +1 -1
- package/dist/commands/evidence.js +2 -1
- package/dist/commands/evidence.js.map +1 -1
- package/dist/commands/fix.d.ts.map +1 -1
- package/dist/commands/fix.js +12 -4
- package/dist/commands/fix.js.map +1 -1
- package/dist/commands/init.d.ts.map +1 -1
- package/dist/commands/init.js +2 -1
- package/dist/commands/init.js.map +1 -1
- package/dist/commands/lock.d.ts.map +1 -1
- package/dist/commands/lock.js +7 -2
- package/dist/commands/lock.js.map +1 -1
- package/dist/commands/maintain.d.ts.map +1 -1
- package/dist/commands/maintain.js +13 -0
- package/dist/commands/maintain.js.map +1 -1
- package/dist/commands/plugin.d.ts.map +1 -1
- package/dist/commands/plugin.js +5 -4
- package/dist/commands/plugin.js.map +1 -1
- package/dist/commands/snapshot.d.ts.map +1 -1
- package/dist/commands/snapshot.js +16 -0
- package/dist/commands/snapshot.js.map +1 -1
- package/dist/commands/status.d.ts.map +1 -1
- package/dist/commands/status.js +2 -0
- package/dist/commands/status.js.map +1 -1
- package/dist/commands/update.d.ts.map +1 -1
- package/dist/commands/update.js +30 -10
- package/dist/commands/update.js.map +1 -1
- package/dist/core/audit/commands.d.ts +4 -1
- package/dist/core/audit/commands.d.ts.map +1 -1
- package/dist/core/audit/commands.js +7 -3
- package/dist/core/audit/commands.js.map +1 -1
- package/dist/core/audit/diff.d.ts +31 -0
- package/dist/core/audit/diff.d.ts.map +1 -1
- package/dist/core/audit/diff.js +43 -0
- package/dist/core/audit/diff.js.map +1 -1
- package/dist/core/audit/errors.d.ts +4 -0
- package/dist/core/audit/errors.d.ts.map +1 -0
- package/dist/core/audit/errors.js +4 -0
- package/dist/core/audit/errors.js.map +1 -0
- package/dist/core/audit/fix-history.d.ts.map +1 -1
- package/dist/core/audit/fix-history.js +3 -5
- package/dist/core/audit/fix-history.js.map +1 -1
- package/dist/core/audit/fix.d.ts.map +1 -1
- package/dist/core/audit/fix.js +16 -18
- package/dist/core/audit/fix.js.map +1 -1
- package/dist/core/audit/history.d.ts +8 -0
- package/dist/core/audit/history.d.ts.map +1 -1
- package/dist/core/audit/history.js +67 -5
- package/dist/core/audit/history.js.map +1 -1
- package/dist/core/audit/index.d.ts.map +1 -1
- package/dist/core/audit/index.js +24 -12
- package/dist/core/audit/index.js.map +1 -1
- package/dist/core/audit/listChecks.d.ts.map +1 -1
- package/dist/core/audit/listChecks.js +2 -1
- package/dist/core/audit/listChecks.js.map +1 -1
- package/dist/core/audit/pluginAudit.d.ts +10 -0
- package/dist/core/audit/pluginAudit.d.ts.map +1 -1
- package/dist/core/audit/pluginAudit.js +59 -23
- package/dist/core/audit/pluginAudit.js.map +1 -1
- package/dist/core/audit/pluginFix.d.ts +22 -1
- package/dist/core/audit/pluginFix.d.ts.map +1 -1
- package/dist/core/audit/pluginFix.js +27 -10
- package/dist/core/audit/pluginFix.js.map +1 -1
- package/dist/core/audit/regression.d.ts +1 -0
- package/dist/core/audit/regression.d.ts.map +1 -1
- package/dist/core/audit/regression.js +7 -5
- package/dist/core/audit/regression.js.map +1 -1
- package/dist/core/audit/snapshot.d.ts.map +1 -1
- package/dist/core/audit/snapshot.js +3 -4
- package/dist/core/audit/snapshot.js.map +1 -1
- package/dist/core/audit/types.d.ts +2 -2
- package/dist/core/audit/types.d.ts.map +1 -1
- package/dist/core/completions.d.ts.map +1 -1
- package/dist/core/completions.js +71 -47
- package/dist/core/completions.js.map +1 -1
- package/dist/core/configRepair.d.ts.map +1 -1
- package/dist/core/configRepair.js +5 -12
- package/dist/core/configRepair.js.map +1 -1
- package/dist/core/doctor.d.ts +2 -1
- package/dist/core/doctor.d.ts.map +1 -1
- package/dist/core/doctor.js +4 -5
- package/dist/core/doctor.js.map +1 -1
- package/dist/core/evidence.d.ts.map +1 -1
- package/dist/core/evidence.js +4 -7
- package/dist/core/evidence.js.map +1 -1
- package/dist/core/fleet.d.ts +5 -2
- package/dist/core/fleet.d.ts.map +1 -1
- package/dist/core/fleet.js +34 -22
- package/dist/core/fleet.js.map +1 -1
- package/dist/core/notify.d.ts.map +1 -1
- package/dist/core/notify.js +13 -24
- package/dist/core/notify.js.map +1 -1
- package/dist/core/plugin/audit.d.ts +25 -0
- package/dist/core/plugin/audit.d.ts.map +1 -0
- package/dist/core/plugin/audit.js +43 -0
- package/dist/core/plugin/audit.js.map +1 -0
- package/dist/core/plugin.d.ts +19 -6
- package/dist/core/plugin.d.ts.map +1 -1
- package/dist/core/plugin.js +40 -19
- package/dist/core/plugin.js.map +1 -1
- package/dist/core/provision.d.ts +25 -1
- package/dist/core/provision.d.ts.map +1 -1
- package/dist/core/provision.js +127 -12
- package/dist/core/provision.js.map +1 -1
- package/dist/core/scheduleManager.d.ts.map +1 -1
- package/dist/core/scheduleManager.js +7 -8
- package/dist/core/scheduleManager.js.map +1 -1
- package/dist/core/tokens.d.ts +1 -1
- package/dist/core/tokens.d.ts.map +1 -1
- package/dist/core/tokens.js +12 -11
- package/dist/core/tokens.js.map +1 -1
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -1
- package/dist/mcp/index.js +2 -2
- package/dist/mcp/index.js.map +1 -1
- package/dist/mcp/server.d.ts +14 -0
- package/dist/mcp/server.d.ts.map +1 -1
- package/dist/mcp/server.js +118 -96
- package/dist/mcp/server.js.map +1 -1
- package/dist/mcp/startupDiagnostic.d.ts +6 -0
- package/dist/mcp/startupDiagnostic.d.ts.map +1 -0
- package/dist/mcp/startupDiagnostic.js +7 -0
- package/dist/mcp/startupDiagnostic.js.map +1 -0
- package/dist/mcp/tools/serverAudit.d.ts +2 -1
- package/dist/mcp/tools/serverAudit.d.ts.map +1 -1
- package/dist/mcp/tools/serverAudit.js.map +1 -1
- package/dist/mcp/tools/serverBackup.handlers.d.ts.map +1 -1
- package/dist/mcp/tools/serverBackup.handlers.js +1 -0
- package/dist/mcp/tools/serverBackup.handlers.js.map +1 -1
- package/dist/mcp/tools/serverCompare.d.ts +13 -14
- package/dist/mcp/tools/serverCompare.d.ts.map +1 -1
- package/dist/mcp/tools/serverCompare.js +20 -15
- package/dist/mcp/tools/serverCompare.js.map +1 -1
- package/dist/mcp/tools/serverFix.d.ts +61 -17
- package/dist/mcp/tools/serverFix.d.ts.map +1 -1
- package/dist/mcp/tools/serverFix.js +67 -78
- package/dist/mcp/tools/serverFix.js.map +1 -1
- package/dist/mcp/tools/serverGuard.d.ts.map +1 -1
- package/dist/mcp/tools/serverGuard.js +4 -1
- package/dist/mcp/tools/serverGuard.js.map +1 -1
- package/dist/mcp/tools/serverInfo.d.ts +11 -3
- package/dist/mcp/tools/serverInfo.d.ts.map +1 -1
- package/dist/mcp/tools/serverInfo.js +11 -3
- package/dist/mcp/tools/serverInfo.js.map +1 -1
- package/dist/mcp/tools/serverLogs.d.ts.map +1 -1
- package/dist/mcp/tools/serverLogs.js +2 -1
- package/dist/mcp/tools/serverLogs.js.map +1 -1
- package/dist/mcp/tools/serverMaintain.d.ts +4 -2
- package/dist/mcp/tools/serverMaintain.d.ts.map +1 -1
- package/dist/mcp/tools/serverMaintain.js +4 -2
- package/dist/mcp/tools/serverMaintain.js.map +1 -1
- package/dist/mcp/tools/serverPlugin.js +2 -2
- package/dist/mcp/tools/serverPlugin.js.map +1 -1
- package/dist/mcp/tools/serverProvision.d.ts +8 -0
- package/dist/mcp/tools/serverProvision.d.ts.map +1 -1
- package/dist/mcp/tools/serverProvision.js +31 -3
- package/dist/mcp/tools/serverProvision.js.map +1 -1
- package/dist/mcp/tools/serverSecure.actions.d.ts +21 -0
- package/dist/mcp/tools/serverSecure.actions.d.ts.map +1 -0
- package/dist/mcp/tools/serverSecure.actions.js +22 -0
- package/dist/mcp/tools/serverSecure.actions.js.map +1 -0
- package/dist/mcp/tools/serverSecure.d.ts +23 -1
- package/dist/mcp/tools/serverSecure.d.ts.map +1 -1
- package/dist/mcp/tools/serverSecure.js +16 -9
- package/dist/mcp/tools/serverSecure.js.map +1 -1
- package/dist/mcp/utils/parseMetrics.d.ts +27 -0
- package/dist/mcp/utils/parseMetrics.d.ts.map +1 -0
- package/dist/mcp/utils/parseMetrics.js +35 -0
- package/dist/mcp/utils/parseMetrics.js.map +1 -0
- package/dist/mcp/utils.d.ts +9 -0
- package/dist/mcp/utils.d.ts.map +1 -1
- package/dist/mcp/utils.js +1 -2
- package/dist/mcp/utils.js.map +1 -1
- package/dist/mcp-bundle.mjs +5862 -4939
- package/dist/plugin/loader.js +3 -2
- package/dist/plugin/loader.js.map +1 -1
- package/dist/plugin/registry.d.ts +26 -5
- package/dist/plugin/registry.d.ts.map +1 -1
- package/dist/plugin/registry.js +46 -18
- package/dist/plugin/registry.js.map +1 -1
- package/dist/plugin/sdk/constants.d.ts +2 -0
- package/dist/plugin/sdk/constants.d.ts.map +1 -1
- package/dist/plugin/sdk/constants.js +1 -0
- package/dist/plugin/sdk/constants.js.map +1 -1
- package/dist/plugin/sdk/types.d.ts +18 -4
- package/dist/plugin/sdk/types.d.ts.map +1 -1
- package/dist/plugin/sdk/types.js +1 -1
- package/dist/plugin/sdk/types.js.map +1 -1
- package/dist/plugin/validate.d.ts.map +1 -1
- package/dist/plugin/validate.js +17 -8
- package/dist/plugin/validate.js.map +1 -1
- package/dist/types/severity.d.ts +3 -0
- package/dist/types/severity.d.ts.map +1 -0
- package/dist/types/severity.js +2 -0
- package/dist/types/severity.js.map +1 -0
- package/dist/utils/atomicWrite.d.ts +23 -0
- package/dist/utils/atomicWrite.d.ts.map +1 -0
- package/dist/utils/atomicWrite.js +44 -0
- package/dist/utils/atomicWrite.js.map +1 -0
- package/dist/utils/concurrency.d.ts +17 -0
- package/dist/utils/concurrency.d.ts.map +1 -0
- package/dist/utils/concurrency.js +38 -0
- package/dist/utils/concurrency.js.map +1 -0
- package/dist/utils/config.d.ts +1 -0
- package/dist/utils/config.d.ts.map +1 -1
- package/dist/utils/config.js +44 -33
- package/dist/utils/config.js.map +1 -1
- package/dist/utils/encryption.d.ts.map +1 -1
- package/dist/utils/encryption.js +7 -2
- package/dist/utils/encryption.js.map +1 -1
- package/dist/utils/exitCode.d.ts +2 -0
- package/dist/utils/exitCode.d.ts.map +1 -0
- package/dist/utils/exitCode.js +4 -0
- package/dist/utils/exitCode.js.map +1 -0
- package/dist/utils/fileLock.d.ts.map +1 -1
- package/dist/utils/fileLock.js +177 -30
- package/dist/utils/fileLock.js.map +1 -1
- package/dist/utils/fsMtime.d.ts +32 -0
- package/dist/utils/fsMtime.d.ts.map +1 -0
- package/dist/utils/fsMtime.js +61 -0
- package/dist/utils/fsMtime.js.map +1 -0
- package/dist/utils/fsRetry.d.ts +20 -0
- package/dist/utils/fsRetry.d.ts.map +1 -0
- package/dist/utils/fsRetry.js +56 -0
- package/dist/utils/fsRetry.js.map +1 -0
- package/dist/utils/logger.d.ts +1 -1
- package/dist/utils/logger.d.ts.map +1 -1
- package/dist/utils/logger.js +8 -3
- package/dist/utils/logger.js.map +1 -1
- package/dist/utils/openBrowser.d.ts.map +1 -1
- package/dist/utils/openBrowser.js +3 -2
- package/dist/utils/openBrowser.js.map +1 -1
- package/dist/utils/platform.d.ts +2 -0
- package/dist/utils/platform.d.ts.map +1 -0
- package/dist/utils/platform.js +2 -0
- package/dist/utils/platform.js.map +1 -0
- package/dist/utils/secureWrite.d.ts +1 -0
- package/dist/utils/secureWrite.d.ts.map +1 -1
- package/dist/utils/secureWrite.js +8 -2
- package/dist/utils/secureWrite.js.map +1 -1
- package/dist/utils/securityLogger.d.ts.map +1 -1
- package/dist/utils/securityLogger.js +16 -4
- package/dist/utils/securityLogger.js.map +1 -1
- package/dist/utils/ssh.d.ts +2 -1
- package/dist/utils/ssh.d.ts.map +1 -1
- package/dist/utils/ssh.js +14 -4
- package/dist/utils/ssh.js.map +1 -1
- package/dist/utils/version.d.ts +5 -0
- package/dist/utils/version.d.ts.map +1 -1
- package/dist/utils/version.js +26 -0
- package/dist/utils/version.js.map +1 -1
- package/dist/utils/webhookSecurity.d.ts +13 -0
- package/dist/utils/webhookSecurity.d.ts.map +1 -0
- package/dist/utils/webhookSecurity.js +130 -0
- package/dist/utils/webhookSecurity.js.map +1 -0
- package/kastell-plugin/.claude-plugin/plugin.json +2 -2
- package/kastell-plugin/README.md +6 -0
- package/package.json +3 -4
package/dist/plugin/loader.js
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { FAILED_PLUGIN_PREFIX } from "./sdk/constants.js";
|
|
2
|
+
import { PLUGIN_STATUS_LOADED } from "./registry.js";
|
|
2
3
|
import { existsSync, readdirSync, readFileSync } from "fs";
|
|
3
4
|
import { join, resolve, sep } from "path";
|
|
4
5
|
import { pathToFileURL } from "url";
|
|
@@ -25,7 +26,7 @@ export async function loadPlugins(options) {
|
|
|
25
26
|
const failedManifest = () => ({
|
|
26
27
|
name: dir.name,
|
|
27
28
|
version: "0.0.0",
|
|
28
|
-
apiVersion: "
|
|
29
|
+
apiVersion: "2",
|
|
29
30
|
kastell: "*",
|
|
30
31
|
capabilities: ["audit"],
|
|
31
32
|
checkPrefix: FAILED_PLUGIN_PREFIX,
|
|
@@ -118,7 +119,7 @@ export async function loadPlugins(options) {
|
|
|
118
119
|
errors.push(extractReason(result.reason));
|
|
119
120
|
}
|
|
120
121
|
}
|
|
121
|
-
const manifests = mapRegistryPlugins((_, entry) => entry.status ===
|
|
122
|
+
const manifests = mapRegistryPlugins((_, entry) => entry.status === PLUGIN_STATUS_LOADED ? entry.manifest : null).filter((m) => m !== null);
|
|
122
123
|
savePluginCache(manifests);
|
|
123
124
|
return { loaded, errors };
|
|
124
125
|
}
|
|
@@ -1 +1 @@
|
|
|
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;
|
|
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,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,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;AAYvB,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,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAC9D,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"}
|
|
@@ -1,17 +1,38 @@
|
|
|
1
1
|
import type { PluginManifest, PluginCheck, PluginCommand, PluginMcpTool, PluginFix } from "./sdk/types.js";
|
|
2
|
-
|
|
2
|
+
/**
|
|
3
|
+
* Status string-literal constants. CQS-08: prefer these over `"loaded"` magic
|
|
4
|
+
* strings at call sites. `as const` preserves the literal type so discriminated
|
|
5
|
+
* union narrowing (`entry.status === PLUGIN_STATUS_LOADED`) still narrows
|
|
6
|
+
* correctly to the loaded variant.
|
|
7
|
+
*/
|
|
8
|
+
export declare const PLUGIN_STATUS_LOADED: "loaded";
|
|
9
|
+
export declare const PLUGIN_STATUS_FAILED: "failed";
|
|
10
|
+
export declare const PLUGIN_STATUS_DISABLED: "disabled";
|
|
11
|
+
export type PluginRegistryEntry = ({
|
|
12
|
+
status: "loaded";
|
|
3
13
|
manifest: PluginManifest;
|
|
4
14
|
checks: PluginCheck[];
|
|
5
|
-
status: "loaded" | "failed";
|
|
6
|
-
reason?: string;
|
|
7
15
|
commands?: PluginCommand[];
|
|
8
16
|
mcpTools?: PluginMcpTool[];
|
|
9
|
-
fixes?: PluginFix[];
|
|
10
17
|
checksById: ReadonlyMap<string, PluginCheck>;
|
|
11
18
|
fixesByCheckId: ReadonlyMap<string, PluginFix>;
|
|
12
|
-
}
|
|
19
|
+
}) | ({
|
|
20
|
+
status: "failed";
|
|
21
|
+
manifest: PluginManifest;
|
|
22
|
+
reason: string;
|
|
23
|
+
checks: [];
|
|
24
|
+
checksById: ReadonlyMap<string, never>;
|
|
25
|
+
fixesByCheckId: ReadonlyMap<string, never>;
|
|
26
|
+
}) | ({
|
|
27
|
+
status: "disabled";
|
|
28
|
+
manifest: PluginManifest;
|
|
29
|
+
checks: [];
|
|
30
|
+
checksById: ReadonlyMap<string, never>;
|
|
31
|
+
fixesByCheckId: ReadonlyMap<string, never>;
|
|
32
|
+
});
|
|
13
33
|
export declare function registerPlugin(manifest: PluginManifest, checks: PluginCheck[]): void;
|
|
14
34
|
export declare function registerFailedPlugin(manifest: PluginManifest, reason: string): void;
|
|
35
|
+
export declare function registerDisabledPlugin(manifest: PluginManifest): void;
|
|
15
36
|
export declare function deletePlugin(name: string): void;
|
|
16
37
|
export declare function mapRegistryPlugins<T>(callback: (name: string, entry: PluginRegistryEntry) => T): T[];
|
|
17
38
|
export interface PluginCommandEntry {
|
|
@@ -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,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAM3G,MAAM,
|
|
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;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAG,QAAiB,CAAC;AACtD,eAAO,MAAM,oBAAoB,EAAG,QAAiB,CAAC;AACtD,eAAO,MAAM,sBAAsB,EAAG,UAAmB,CAAC;AAK1D,MAAM,MAAM,mBAAmB,GAC3B,CAAC;IACC,MAAM,EAAE,QAAQ,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC7C,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAChD,CAAC,GACF,CAAC;IACC,MAAM,EAAE,QAAQ,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,EAAE,CAAC;IACX,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACvC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC5C,CAAC,GACF,CAAC;IACC,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,EAAE,CAAC;IACX,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACvC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC5C,CAAC,CAAC;AAkDP,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,WAAW,EAAE,GACpB,IAAI,CAyCN;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,GACb,IAAI,CAEN;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,GACvB,IAAI,CAEN;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"}
|
package/dist/plugin/registry.js
CHANGED
|
@@ -6,6 +6,47 @@ import { KASTELL_DIR, PLUGINS_NODE_MODULES } from "../utils/paths.js";
|
|
|
6
6
|
import { debugLog } from "../utils/logger.js";
|
|
7
7
|
import { PLUGIN_NAME_PREFIX, PLUGIN_TOOL_PREFIX } from "./sdk/constants.js";
|
|
8
8
|
const PLUGIN_CACHE_PATH = join(KASTELL_DIR, "plugin-manifests.json");
|
|
9
|
+
/**
|
|
10
|
+
* Status string-literal constants. CQS-08: prefer these over `"loaded"` magic
|
|
11
|
+
* strings at call sites. `as const` preserves the literal type so discriminated
|
|
12
|
+
* union narrowing (`entry.status === PLUGIN_STATUS_LOADED`) still narrows
|
|
13
|
+
* correctly to the loaded variant.
|
|
14
|
+
*/
|
|
15
|
+
export const PLUGIN_STATUS_LOADED = "loaded";
|
|
16
|
+
export const PLUGIN_STATUS_FAILED = "failed";
|
|
17
|
+
export const PLUGIN_STATUS_DISABLED = "disabled";
|
|
18
|
+
// Typed builders — return the discriminated variant directly so call sites
|
|
19
|
+
// don't need `as unknown as PluginRegistryEntry` (P139 simplify C3).
|
|
20
|
+
function createLoadedEntry(manifest, checks, checksById, fixesById) {
|
|
21
|
+
return {
|
|
22
|
+
status: "loaded",
|
|
23
|
+
manifest,
|
|
24
|
+
checks,
|
|
25
|
+
checksById,
|
|
26
|
+
fixesByCheckId: fixesById,
|
|
27
|
+
commands: manifest.commands,
|
|
28
|
+
mcpTools: manifest.mcpTools,
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
function createFailedEntry(manifest, reason) {
|
|
32
|
+
return {
|
|
33
|
+
status: "failed",
|
|
34
|
+
manifest,
|
|
35
|
+
reason,
|
|
36
|
+
checks: [],
|
|
37
|
+
checksById: new Map(),
|
|
38
|
+
fixesByCheckId: new Map(),
|
|
39
|
+
};
|
|
40
|
+
}
|
|
41
|
+
function createDisabledEntry(manifest) {
|
|
42
|
+
return {
|
|
43
|
+
status: "disabled",
|
|
44
|
+
manifest,
|
|
45
|
+
checks: [],
|
|
46
|
+
checksById: new Map(),
|
|
47
|
+
fixesByCheckId: new Map(),
|
|
48
|
+
};
|
|
49
|
+
}
|
|
9
50
|
const PLUGIN_REGISTRY = new Map();
|
|
10
51
|
const usedPrefixes = new Map();
|
|
11
52
|
const usedCheckIds = new Set();
|
|
@@ -37,26 +78,13 @@ export function registerPlugin(manifest, checks) {
|
|
|
37
78
|
for (const fix of manifest.fixes)
|
|
38
79
|
fixesByCheckId.set(fix.checkId, fix);
|
|
39
80
|
}
|
|
40
|
-
PLUGIN_REGISTRY.set(manifest.name,
|
|
41
|
-
manifest,
|
|
42
|
-
checks,
|
|
43
|
-
status: "loaded",
|
|
44
|
-
commands: manifest.commands,
|
|
45
|
-
mcpTools: manifest.mcpTools,
|
|
46
|
-
fixes: manifest.fixes,
|
|
47
|
-
checksById,
|
|
48
|
-
fixesByCheckId,
|
|
49
|
-
});
|
|
81
|
+
PLUGIN_REGISTRY.set(manifest.name, createLoadedEntry(manifest, checks, checksById, fixesByCheckId));
|
|
50
82
|
}
|
|
51
83
|
export function registerFailedPlugin(manifest, reason) {
|
|
52
|
-
PLUGIN_REGISTRY.set(manifest.name,
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
reason,
|
|
57
|
-
checksById: new Map(),
|
|
58
|
-
fixesByCheckId: new Map(),
|
|
59
|
-
});
|
|
84
|
+
PLUGIN_REGISTRY.set(manifest.name, createFailedEntry(manifest, reason));
|
|
85
|
+
}
|
|
86
|
+
export function registerDisabledPlugin(manifest) {
|
|
87
|
+
PLUGIN_REGISTRY.set(manifest.name, createDisabledEntry(manifest));
|
|
60
88
|
}
|
|
61
89
|
export function deletePlugin(name) {
|
|
62
90
|
const entry = PLUGIN_REGISTRY.get(name);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/plugin/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEtE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,MAAM,iBAAiB,GAAG,IAAI,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/plugin/registry.ts"],"names":[],"mappings":"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"}
|
|
@@ -2,4 +2,6 @@ export declare const PLUGIN_NAME_PATTERN: RegExp;
|
|
|
2
2
|
export declare const FAILED_PLUGIN_PREFIX = "ERR";
|
|
3
3
|
export declare const PLUGIN_NAME_PREFIX = "kastell-plugin-";
|
|
4
4
|
export declare const PLUGIN_TOOL_PREFIX = "server_plugin_";
|
|
5
|
+
export declare const PLUGIN_API_VERSION: "2";
|
|
6
|
+
export type PluginApiVersion = typeof PLUGIN_API_VERSION;
|
|
5
7
|
//# 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;AAC1C,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AACpD,eAAO,MAAM,kBAAkB,mBAAmB,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;AAEnD,eAAO,MAAM,kBAAkB,EAAG,GAAY,CAAC;AAC/C,MAAM,MAAM,gBAAgB,GAAG,OAAO,kBAAkB,CAAC"}
|
|
@@ -2,4 +2,5 @@ export const PLUGIN_NAME_PATTERN = /^kastell-plugin-[a-z0-9-]+$/;
|
|
|
2
2
|
export const FAILED_PLUGIN_PREFIX = "ERR";
|
|
3
3
|
export const PLUGIN_NAME_PREFIX = "kastell-plugin-";
|
|
4
4
|
export const PLUGIN_TOOL_PREFIX = "server_plugin_";
|
|
5
|
+
export const PLUGIN_API_VERSION = "2";
|
|
5
6
|
//# 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;AAC1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,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;AAEnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAY,CAAC"}
|
|
@@ -1,6 +1,10 @@
|
|
|
1
|
+
import type { Severity, FixTier } from "../../types/severity.js";
|
|
2
|
+
import type { PluginApiVersion } from "./constants.js";
|
|
1
3
|
export type PluginCapability = "audit" | "command" | "mcp-tool" | "fix";
|
|
2
|
-
export type PluginSeverity =
|
|
3
|
-
export type PluginFixTier =
|
|
4
|
+
export type PluginSeverity = Severity;
|
|
5
|
+
export type PluginFixTier = FixTier;
|
|
6
|
+
export declare const PLUGIN_CHECK_COMMAND_KINDS: readonly ["read", "mutate-local", "mutate-global"];
|
|
7
|
+
export type PluginCheckCommandKind = (typeof PLUGIN_CHECK_COMMAND_KINDS)[number];
|
|
4
8
|
export interface PluginCommand {
|
|
5
9
|
name: string;
|
|
6
10
|
description: string;
|
|
@@ -41,10 +45,20 @@ export interface PluginFix {
|
|
|
41
45
|
handler: string;
|
|
42
46
|
backupPaths?: string[];
|
|
43
47
|
}
|
|
48
|
+
export type PluginCheckCommand = {
|
|
49
|
+
kind: "read";
|
|
50
|
+
cmd: string;
|
|
51
|
+
} | {
|
|
52
|
+
kind: "mutate-local";
|
|
53
|
+
cmd: string;
|
|
54
|
+
} | {
|
|
55
|
+
kind: "mutate-global";
|
|
56
|
+
cmd: string;
|
|
57
|
+
};
|
|
44
58
|
export interface PluginManifest {
|
|
45
59
|
name: string;
|
|
46
60
|
version: string;
|
|
47
|
-
apiVersion:
|
|
61
|
+
apiVersion: PluginApiVersion;
|
|
48
62
|
kastell: string;
|
|
49
63
|
capabilities: PluginCapability[];
|
|
50
64
|
checkPrefix: string;
|
|
@@ -59,7 +73,7 @@ export interface PluginCheck {
|
|
|
59
73
|
category: string;
|
|
60
74
|
severity: PluginSeverity;
|
|
61
75
|
description: string;
|
|
62
|
-
checkCommand:
|
|
76
|
+
checkCommand: PluginCheckCommand;
|
|
63
77
|
passPattern?: string;
|
|
64
78
|
failPattern?: string;
|
|
65
79
|
fixCommand?: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugin/sdk/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugin/sdk/types.ts"],"names":[],"mappings":"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"}
|
package/dist/plugin/sdk/types.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export
|
|
1
|
+
export const PLUGIN_CHECK_COMMAND_KINDS = ["read", "mutate-local", "mutate-global"];
|
|
2
2
|
//# sourceMappingURL=types.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugin/sdk/types.ts"],"names":[],"mappings":""}
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugin/sdk/types.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,eAAe,CAAU,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
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;
|
|
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;AA8ElE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,cAAc,CA6DlE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAwBlF"}
|
package/dist/plugin/validate.js
CHANGED
|
@@ -2,7 +2,8 @@ import { z } from "zod";
|
|
|
2
2
|
import semver from "semver";
|
|
3
3
|
import { ValidationError } from "../utils/errors.js";
|
|
4
4
|
import { KASTELL_VERSION } from "../utils/version.js";
|
|
5
|
-
import { PLUGIN_NAME_PATTERN } from "./sdk/constants.js";
|
|
5
|
+
import { PLUGIN_NAME_PATTERN, PLUGIN_API_VERSION } from "./sdk/constants.js";
|
|
6
|
+
import { PLUGIN_CHECK_COMMAND_KINDS } from "./sdk/types.js";
|
|
6
7
|
const HANDLER_PATH_PATTERN = /^\.\/(?!.*\.\.)(?:[a-zA-Z0-9_-]+\/)*[a-zA-Z0-9_-]+\.js$/;
|
|
7
8
|
const PluginCommandSchema = z.object({
|
|
8
9
|
name: z.string().min(1),
|
|
@@ -20,6 +21,19 @@ const PluginFixSchema = z.object({
|
|
|
20
21
|
handler: z.string().regex(HANDLER_PATH_PATTERN, "Handler must be relative ./path.js"),
|
|
21
22
|
backupPaths: z.array(z.string().regex(/^\//, "Backup path must be absolute")).optional(),
|
|
22
23
|
});
|
|
24
|
+
const PluginCheckCommandSchema = z
|
|
25
|
+
.object({
|
|
26
|
+
kind: z.enum(PLUGIN_CHECK_COMMAND_KINDS, {
|
|
27
|
+
error: `checkCommand.kind must be one of: ${PLUGIN_CHECK_COMMAND_KINDS.join(", ")}`,
|
|
28
|
+
}),
|
|
29
|
+
cmd: z
|
|
30
|
+
.string()
|
|
31
|
+
.min(1)
|
|
32
|
+
.refine((s) => !s.includes("---SECTION:"), "checkCommand.cmd must not contain '---SECTION:' substring")
|
|
33
|
+
.refine((s) => !s.includes("KASTELL_PLUGIN_CHECK_EOF"), "checkCommand.cmd must not contain heredoc tag 'KASTELL_PLUGIN_CHECK_EOF'")
|
|
34
|
+
.refine((s) => !/\r/.test(s), "checkCommand.cmd must not contain CR characters"),
|
|
35
|
+
})
|
|
36
|
+
.strict();
|
|
23
37
|
const PluginCheckSchema = z.object({
|
|
24
38
|
id: z
|
|
25
39
|
.string()
|
|
@@ -28,12 +42,7 @@ const PluginCheckSchema = z.object({
|
|
|
28
42
|
name: z.string().min(1),
|
|
29
43
|
severity: z.enum(["critical", "warning", "info"]),
|
|
30
44
|
description: z.string().optional(),
|
|
31
|
-
checkCommand:
|
|
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"),
|
|
45
|
+
checkCommand: PluginCheckCommandSchema,
|
|
37
46
|
passPattern: z.string().optional(),
|
|
38
47
|
failPattern: z.string().optional(),
|
|
39
48
|
fixCommand: z.string().optional(),
|
|
@@ -52,7 +61,7 @@ const PluginManifestSchema = z
|
|
|
52
61
|
.object({
|
|
53
62
|
name: z.string().regex(PLUGIN_NAME_PATTERN, "Name must match kastell-plugin-<lowercase>"),
|
|
54
63
|
version: z.string().regex(/^\d+\.\d+\.\d+$/, "Version must be semver (X.Y.Z)"),
|
|
55
|
-
apiVersion: z.literal(
|
|
64
|
+
apiVersion: z.literal(PLUGIN_API_VERSION),
|
|
56
65
|
kastell: z.string().min(1, "Kastell version range required"),
|
|
57
66
|
capabilities: z.array(z.enum(["audit", "command", "mcp-tool", "fix"])).min(1),
|
|
58
67
|
checkPrefix: z.string().regex(/^[A-Z]{2,6}$/, "checkPrefix must be 2-6 uppercase letters"),
|
|
@@ -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;
|
|
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,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAE5D,MAAM,oBAAoB,GAAG,yDAAyD,CAAC;AAEvF,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,oBAAoB,EAAE,oCAAoC,CAAC;CACtF,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,oBAAoB,EAAE,oCAAoC,CAAC;CACtF,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,oBAAoB,EAAE,oCAAoC,CAAC;IACrF,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,8BAA8B,CAAC,CAAC,CAAC,QAAQ,EAAE;CACzF,CAAC,CAAC;AAEH,MAAM,wBAAwB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,0BAA0B,EAAE;QACvC,KAAK,EAAE,qCAAqC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KACpF,CAAC;IACF,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,2DAA2D,CAAC;SACtG,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,0EAA0E,CAAC;SAClI,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,iDAAiD,CAAC;CACnF,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,EAAE,EAAE,CAAC;SACF,MAAM,EAAE;SACR,KAAK,CAAC,yBAAyB,EAAE,qEAAqE,CAAC;IAC1G,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACjD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,YAAY,EAAE,wBAAwB;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClE,OAAO,EAAE,CAAC;SACP,KAAK,CAAC;QACL,CAAC,CAAC,MAAM,EAAE;QACV,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;KAC/C,CAAC;SACD,QAAQ,EAAE;IACb,cAAc,EAAE,CAAC;SACd,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;SAC3D,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH,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,kBAAkB,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;IAC5D,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7E,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;IAChD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE;IACjD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE;IACjD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;CAC3C,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,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACtB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,eAAe,CACvB,gBAAgB,GAAG,CAAC,OAAO,oCAAoC,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,CAC3F,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YACzC,MAAM,IAAI,eAAe,CAAC,yCAAyC,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YACzC,MAAM,IAAI,eAAe,CAAC,yCAAyC,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,MAAM,IAAI,eAAe,CAAC,wCAAwC,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,eAAe,CAAC,8CAA8C,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,eAAe,CAAC,+CAA+C,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,eAAe,CAAC,uCAAuC,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAe,EAAE,WAAmB;IACjE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,eAAe,CAAC,gCAAgC,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,eAAe,CAAC,iCAAiC,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3F,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,GAAG,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,eAAe,CACvB,aAAa,KAAK,CAAC,EAAE,oCAAoC,WAAW,IAAI,CACzE,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,eAAe,CAAC,uBAAuB,KAAK,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,KAAoB,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"severity.d.ts","sourceRoot":"","sources":["../../src/types/severity.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AACvD,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"severity.js","sourceRoot":"","sources":["../../src/types/severity.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { type WriteFileOptions } from "./secureWrite.js";
|
|
2
|
+
export interface AtomicWriteOptions extends WriteFileOptions {
|
|
3
|
+
attempts?: number;
|
|
4
|
+
delayMs?: number;
|
|
5
|
+
}
|
|
6
|
+
/**
|
|
7
|
+
* Write a file through `targetPath + ".tmp"` and rename it into place.
|
|
8
|
+
*
|
|
9
|
+
* `renameSync()` is the primary path and is atomic. On transient Windows
|
|
10
|
+
* permission failures from file scanners (antivirus, OneDrive, search indexer)
|
|
11
|
+
* or sync clients, this helper retries. If retries exhaust on permission
|
|
12
|
+
* errors, it falls back to `copyFileSync + unlinkSync`. That fallback is
|
|
13
|
+
* best-effort and not atomic — under crash between `copyFileSync` and
|
|
14
|
+
* `unlinkSync`, the target may be left torn between the old and new content.
|
|
15
|
+
* Callers that cannot tolerate torn state must wrap the call in a file lock
|
|
16
|
+
* (see `withFileLock`). Safe to call repeatedly with the same `targetPath`.
|
|
17
|
+
*
|
|
18
|
+
* Retry sleeps are synchronous and block the CLI process briefly.
|
|
19
|
+
*
|
|
20
|
+
* @throws The original non-permission rename error, or the fallback copy error.
|
|
21
|
+
*/
|
|
22
|
+
export declare function atomicWriteFileSync(targetPath: string, content: string, options?: AtomicWriteOptions): void;
|
|
23
|
+
//# sourceMappingURL=atomicWrite.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"atomicWrite.d.ts","sourceRoot":"","sources":["../../src/utils/atomicWrite.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAS9E,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,IAAI,CAuBN"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { copyFileSync, renameSync } from "fs";
|
|
2
|
+
import { secureWriteFileSync } from "./secureWrite.js";
|
|
3
|
+
import { DEFAULT_PERMISSION_RETRY_ATTEMPTS, DEFAULT_PERMISSION_RETRY_DELAY_MS, isPermissionError, retryOnPermission, unlinkBestEffort, } from "./fsRetry.js";
|
|
4
|
+
/**
|
|
5
|
+
* Write a file through `targetPath + ".tmp"` and rename it into place.
|
|
6
|
+
*
|
|
7
|
+
* `renameSync()` is the primary path and is atomic. On transient Windows
|
|
8
|
+
* permission failures from file scanners (antivirus, OneDrive, search indexer)
|
|
9
|
+
* or sync clients, this helper retries. If retries exhaust on permission
|
|
10
|
+
* errors, it falls back to `copyFileSync + unlinkSync`. That fallback is
|
|
11
|
+
* best-effort and not atomic — under crash between `copyFileSync` and
|
|
12
|
+
* `unlinkSync`, the target may be left torn between the old and new content.
|
|
13
|
+
* Callers that cannot tolerate torn state must wrap the call in a file lock
|
|
14
|
+
* (see `withFileLock`). Safe to call repeatedly with the same `targetPath`.
|
|
15
|
+
*
|
|
16
|
+
* Retry sleeps are synchronous and block the CLI process briefly.
|
|
17
|
+
*
|
|
18
|
+
* @throws The original non-permission rename error, or the fallback copy error.
|
|
19
|
+
*/
|
|
20
|
+
export function atomicWriteFileSync(targetPath, content, options = {}) {
|
|
21
|
+
const tmpFile = `${targetPath}.tmp`;
|
|
22
|
+
const { attempts = DEFAULT_PERMISSION_RETRY_ATTEMPTS, delayMs = DEFAULT_PERMISSION_RETRY_DELAY_MS, ...writeOptions } = options;
|
|
23
|
+
secureWriteFileSync(tmpFile, content, writeOptions);
|
|
24
|
+
try {
|
|
25
|
+
retryOnPermission(() => renameSync(tmpFile, targetPath), { attempts, delayMs });
|
|
26
|
+
}
|
|
27
|
+
catch (renameErr) {
|
|
28
|
+
// Non-permission error → propagate immediately. Permission errors are
|
|
29
|
+
// exhausted here, so the copy fallback takes over.
|
|
30
|
+
if (!isPermissionError(renameErr)) {
|
|
31
|
+
unlinkBestEffort(tmpFile);
|
|
32
|
+
throw renameErr;
|
|
33
|
+
}
|
|
34
|
+
try {
|
|
35
|
+
copyFileSync(tmpFile, targetPath);
|
|
36
|
+
}
|
|
37
|
+
catch (copyErr) {
|
|
38
|
+
unlinkBestEffort(tmpFile);
|
|
39
|
+
throw copyErr;
|
|
40
|
+
}
|
|
41
|
+
unlinkBestEffort(tmpFile);
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
//# sourceMappingURL=atomicWrite.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"atomicWrite.js","sourceRoot":"","sources":["../../src/utils/atomicWrite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAyB,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EACL,iCAAiC,EACjC,iCAAiC,EACjC,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAOtB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,OAAe,EACf,UAA8B,EAAE;IAEhC,MAAM,OAAO,GAAG,GAAG,UAAU,MAAM,CAAC;IACpC,MAAM,EAAE,QAAQ,GAAG,iCAAiC,EAAE,OAAO,GAAG,iCAAiC,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IAE/H,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;IAEpD,IAAI,CAAC;QACH,iBAAiB,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;IAAC,OAAO,SAAS,EAAE,CAAC;QACnB,sEAAsE;QACtE,mDAAmD;QACnD,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAC1B,MAAM,SAAS,CAAC;QAClB,CAAC;QACD,IAAI,CAAC;YACH,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,OAAO,EAAE,CAAC;YACjB,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAC1B,MAAM,OAAO,CAAC;QAChB,CAAC;QACD,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Bounded parallel fan-out. Spawns up to `chunkSize` workers that pull from a shared cursor.
|
|
3
|
+
* Contract: `worker` MUST NOT throw — wrap exceptions inside the callback and return a result
|
|
4
|
+
* variant (e.g. `{ ok: false, err }`). An unhandled rejection aborts the whole batch and leaves
|
|
5
|
+
* remaining slots `undefined`. For cancellation, the caller is responsible for short-circuiting
|
|
6
|
+
* inside `worker` (e.g. check `AbortSignal.aborted`).
|
|
7
|
+
*/
|
|
8
|
+
export declare function chunkConcurrent<T, R>(items: T[], chunkSize: number, worker: (item: T, index: number) => Promise<R>): Promise<R[]>;
|
|
9
|
+
/**
|
|
10
|
+
* Bounded parallel fan-out that lets the worker throw. Returns one
|
|
11
|
+
* `PromiseSettledResult<R>` per input item, in input order, so callers
|
|
12
|
+
* don't have to wrap try/catch around their worker bodies just to capture
|
|
13
|
+
* failures. Use when the worker result type can't naturally encode a
|
|
14
|
+
* failure variant (e.g. typed domain objects that don't have a "failed" shape).
|
|
15
|
+
*/
|
|
16
|
+
export declare function chunkConcurrentSettled<T, R>(items: T[], chunkSize: number, worker: (item: T, index: number) => Promise<R>): Promise<PromiseSettledResult<R>[]>;
|
|
17
|
+
//# sourceMappingURL=concurrency.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,CAAC,EACxC,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7C,OAAO,CAAC,CAAC,EAAE,CAAC,CAWd;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAAE,CAAC,EAC/C,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7C,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,CASpC"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Bounded parallel fan-out. Spawns up to `chunkSize` workers that pull from a shared cursor.
|
|
3
|
+
* Contract: `worker` MUST NOT throw — wrap exceptions inside the callback and return a result
|
|
4
|
+
* variant (e.g. `{ ok: false, err }`). An unhandled rejection aborts the whole batch and leaves
|
|
5
|
+
* remaining slots `undefined`. For cancellation, the caller is responsible for short-circuiting
|
|
6
|
+
* inside `worker` (e.g. check `AbortSignal.aborted`).
|
|
7
|
+
*/
|
|
8
|
+
export async function chunkConcurrent(items, chunkSize, worker) {
|
|
9
|
+
const results = new Array(items.length);
|
|
10
|
+
let cursor = 0;
|
|
11
|
+
const workers = Array.from({ length: Math.min(chunkSize, items.length) }, async () => {
|
|
12
|
+
while (cursor < items.length) {
|
|
13
|
+
const idx = cursor++;
|
|
14
|
+
results[idx] = await worker(items[idx], idx);
|
|
15
|
+
}
|
|
16
|
+
});
|
|
17
|
+
await Promise.all(workers);
|
|
18
|
+
return results;
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Bounded parallel fan-out that lets the worker throw. Returns one
|
|
22
|
+
* `PromiseSettledResult<R>` per input item, in input order, so callers
|
|
23
|
+
* don't have to wrap try/catch around their worker bodies just to capture
|
|
24
|
+
* failures. Use when the worker result type can't naturally encode a
|
|
25
|
+
* failure variant (e.g. typed domain objects that don't have a "failed" shape).
|
|
26
|
+
*/
|
|
27
|
+
export async function chunkConcurrentSettled(items, chunkSize, worker) {
|
|
28
|
+
return chunkConcurrent(items, chunkSize, async (item, idx) => {
|
|
29
|
+
try {
|
|
30
|
+
const value = await worker(item, idx);
|
|
31
|
+
return { status: "fulfilled", value };
|
|
32
|
+
}
|
|
33
|
+
catch (reason) {
|
|
34
|
+
return { status: "rejected", reason };
|
|
35
|
+
}
|
|
36
|
+
});
|
|
37
|
+
}
|
|
38
|
+
//# sourceMappingURL=concurrency.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAU,EACV,SAAiB,EACjB,MAA8C;IAE9C,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE;QACnF,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAAU,EACV,SAAiB,EACjB,MAA8C;IAE9C,OAAO,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3D,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACtC,OAAO,EAAE,MAAM,EAAE,WAAoB,EAAE,KAAK,EAAE,CAAC;QACjD,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,OAAO,EAAE,MAAM,EAAE,UAAmB,EAAE,MAAM,EAAE,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}
|
package/dist/utils/config.d.ts
CHANGED
|
@@ -3,6 +3,7 @@ declare const SERVERS_FILE: string;
|
|
|
3
3
|
export declare function getServersRaw(): ServerRecord[];
|
|
4
4
|
/** Atomic write: write to tmp file, then rename to prevent corruption on crash */
|
|
5
5
|
export declare function atomicWriteServers(servers: ServerRecord[]): void;
|
|
6
|
+
export declare function clearServersCache(): void;
|
|
6
7
|
export declare function getServers(): ServerRecord[];
|
|
7
8
|
export declare function saveServer(record: ServerRecord): Promise<void>;
|
|
8
9
|
export declare function updateServer(name: string, updates: Partial<ServerRecord>): Promise<boolean>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;
|
|
1
|
+
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAQtD,QAAA,MAAM,YAAY,QAAoC,CAAC;AAEvD,wBAAgB,aAAa,IAAI,YAAY,EAAE,CAQ9C;AAOD,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAEhE;AAID,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,wBAAgB,UAAU,IAAI,YAAY,EAAE,CA8B3C;AAMD,wBAAsB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBpE;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAUjG;AAED,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAW/D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAIlE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAKzD;AAED,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,CAAC"}
|