xypriss 9.10.0 → 9.10.2

package/dist/cjs/src/plugins/api/PluginAPI.js

@@ -1,10 +1,11 @@
 'use strict';
 
+var PluginHookIds = require('../const/PluginHookIds.js');
+
 /**
  * Plugin API
  * Public API for plugin management as documented in PLUGIN_SYSTEM_GUIDE.md
  */
-// ─── Internal State ──────────────────────────────────────────────────────────
 // ─── Blocked / Private members ───────────────────────────────────────────────
 /**
  * Methods that must never be accessible from outside the module.
@@ -113,6 +114,14 @@ class PluginAPI {
         assertNonEmptyString(Sys, "XyPriss Initialization Error: To create a plugin, you MUST provide the plugin's root path or its '__sys__' instance as the second argument to Plugin.create().\n" +
             "Example: return Plugin.create({ ... }, __sys__.__root__);");
         plugin.__root__ = Sys;
+        if (!plugin.name || typeof plugin.name !== "string") {
+            throw new Error(`XyPriss Plugin Error: "name" is missing or invalid.`);
+        }
+        for (const field of ["description", "version"]) {
+            if (!plugin[field] || typeof plugin[field] !== "string") {
+                throw new Error(`XyPriss Plugin Error: "${field}" is missing or invalid on plugin "${plugin.name}".`);
+            }
+        }
         return plugin;
     }
     /**
@@ -168,7 +177,84 @@ class PluginAPI {
         return {
             name: `void-plugin-${Math.random().toString(36).slice(2, 9)}`,
             version: "1.0.0",
+            description: "A void plugin for testing purposes.",
+        };
+    }
+    /**
+     * Performs a deep inspection of a plugin instance to identify and list all required
+     * cryptographic permissions based on implemented hooks.
+     *
+     * This utility is designed for developers to use during the preparation of their
+     * `package.json` manifest (`xfpm.permissions` field).
+     *
+     * @param plugin - The XyPriss plugin instance to inspect.
+     *
+     * @example
+     * ```typescript
+     * const myPlugin = Plugin.create({ ... }, __sys__.__root__);
+     * Plugin.inspect(myPlugin);
+     * ```
+     */
+    inspect(plugin) {
+        const header = `[XyPriss Plugin Inspector] ${plugin.name} v${plugin.version}`;
+        const line = "═".repeat(header.length);
+        const c = {
+            reset: "\x1b[0m",
+            bold: "\x1b[1m",
+            dim: "\x1b[2m",
+            cyan: "\x1b[36m",
+            green: "\x1b[32m",
+            yellow: "\x1b[33m",
+            red: "\x1b[31m",
+            gray: "\x1b[90m",
+            magenta: "\x1b[35m",
         };
+        console.log(`\n${c.cyan}${line}${c.reset}`);
+        console.log(`${c.bold}${c.cyan}${header}${c.reset}`);
+        console.log(`${c.cyan}${line}${c.reset}`);
+        console.log(`${c.bold}Project Root:${c.reset} ${c.gray}${plugin.__root__ || "Not Captured"}${c.reset}`);
+        console.log(`\n${c.magenta}${c.bold}Detected Hooks & Authorized Permission IDs:${c.reset}`);
+        Object.entries(plugin);
+        const hookKeys = Object.keys(PluginHookIds.HOOK_ID_MAP);
+        let foundCount = 0;
+        // List of privileged IDs that require explicit authorization
+        const privilegedIds = [
+            "PLG.MANAGEMENT.MANAGE_PLUGINS",
+            "XHS.PERM.LOGGING.CONSOLE_INTERCEPT",
+            "XHS.PERM.OPS.AUXILIARY_SERVER",
+            "XHS.PERM.ROUTING.BYPASS_NAMESPACE",
+            "XHS.PERM.ROUTING.OVERWRITE_PROTECTED",
+            "XHS.PERM.HTTP.GLOBAL_MIDDLEWARE",
+            "XHS.PERM.SECURITY.CONFIGS",
+            "XHS.PERM.SECURITY.SENSITIVE_DATA",
+            "XHS.HOOK.HTTP.REQUEST",
+            "XHS.HOOK.HTTP.RESPONSE",
+        ];
+        // DEEP SCAN: Check all known hook and permission keys
+        for (const key of hookKeys) {
+            const hookId = PluginHookIds.HOOK_ID_MAP[key];
+            const value = plugin[key];
+            // If the key exists on the plugin instance (function, boolean, array, etc.)
+            if (value !== undefined) {
+                foundCount++;
+                const meta = PluginHookIds.HOOK_METADATA[hookId];
+                const isPrivileged = privilegedIds.includes(hookId);
+                console.log(`\n  ${c.cyan}○${c.reset} ${c.bold}Hook/Capability:${c.reset} ${c.green}${key}${c.reset}`);
+                console.log(`    ${c.bold}ID:${c.reset}   ${c.yellow}${hookId}${c.reset} ${isPrivileged ? `${c.red}${c.bold}⚠️  [PRIVILEGED]${c.reset}` : ""}`);
+                if (meta) {
+                    console.log(`    ${c.gray}Role:${c.reset} ${meta.action}`);
+                    console.log(`    ${c.gray}Info:${c.reset} ${c.dim}${meta.description}${c.reset}`);
+                }
+            }
+        }
+        if (foundCount === 0) {
+            console.log(`\n  ${c.yellow}No hooks requiring special permissions were detected in this plugin.${c.reset}`);
+        }
+        else {
+            console.log(`\n${c.bold}${c.green}Summary: Found ${foundCount} required permissions.${c.reset}`);
+            console.log(`\n${c.bold}${c.cyan}TIP:${c.reset} Copy the IDs above into your package.json's ${c.bold}"xfpm.permissions"${c.reset} array.`);
+        }
+        console.log(`\n${c.cyan}${line}${c.reset}\n`);
     }
 }
 // ─── Proxy Shield ─────────────────────────────────────────────────────────────

package/dist/cjs/src/plugins/api/PluginAPI.js.map

@@ -1 +1 @@
-{"version":3,"file":"PluginAPI.js","sources":["../../../../../src/plugins/api/PluginAPI.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"PluginAPI.js","sources":["../../../../../src/plugins/api/PluginAPI.ts"],"sourcesContent":[null],"names":["HOOK_ID_MAP","HOOK_METADATA"],"mappings":"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"}

package/dist/cjs/src/xhsc/XyPrissRunner.js

@@ -1,12 +1,10 @@
 'use strict';
 
-var path = require('node:path');
-var fs = require('node:fs');
 var node_child_process = require('node:child_process');
-var node_url = require('node:url');
 var XHSC_SIGNATURE = require('../server/const/XHSC_SIGNATURE.js');
+var Platform = require('./utils/Platform.js');
+var Discovery = require('./utils/Discovery.js');
 
-var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 /**
  * Custom error class for XyPriss system operations.
  */
@@ -48,73 +46,29 @@ class XyPrissRunner {
      * Prioritizes the high-performance Go implementation (XHSC-GO).
      */
     discoverBinary() {
-        const getOsPart = () => {
-            switch (process.platform) {
-                case "win32":
-                    return "windows";
-                case "darwin":
-                    return "darwin";
-                default:
-                    return "linux";
-            }
-        };
-        const getArchPart = () => {
-            switch (process.arch) {
-                case "arm64":
-                    return "arm64";
-                default:
-                    return "amd64"; // Default to amd64/x64
-            }
-        };
-        const osPart = getOsPart();
-        const archPart = getArchPart();
-        const suffix = osPart === "windows" ? ".exe" : "";
+        // 1. Environment Variable Override (Highest Priority)
+        const envPath = Discovery.Discovery.getFromEnv("XYPRISS_XHSC_PATH");
+        if (envPath)
+            return envPath;
+        const osPart = Platform.Platform.getOsPart();
+        const archPart = Platform.Platform.getArchPart();
+        const suffix = Platform.Platform.getBinarySuffix();
         // Candidate names in order of preference
         const goBinName = `xhsc-${osPart}-${archPart}${suffix}`;
         const genericBinName = osPart === "windows" ? "xhsc.exe" : "xhsc";
         const candidates = [goBinName, genericBinName];
-        try {
-            // Get location of *this* file (compiled JS)
-            const __filename = node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('src/xhsc/XyPrissRunner.js', document.baseURI).href)));
-            const scriptDir = path.dirname(__filename);
-            // Bases for recursive search: script location and current working directory
-            const searchBases = [scriptDir, process.cwd()];
-            for (const base of searchBases) {
-                let current = base;
-                // Go up up to 8 levels to handle deeply nested node_modules / virtual_store
-                for (let depth = 0; depth < 8; depth++) {
-                    // Check 1: Standard bin/ at this level
-                    const binDir = path.join(current, "bin");
-                    for (const name of candidates) {
-                        const fullPath = path.join(binDir, name);
-                        if (fs.existsSync(fullPath))
-                            return fullPath;
-                    }
-                    // Check 2: node_modules/.bin (if we are at project/env root)
-                    const nodeModulesBin = path.join(current, "node_modules", ".bin");
-                    for (const name of candidates) {
-                        const fullPath = path.join(nodeModulesBin, name);
-                        if (fs.existsSync(fullPath))
-                            return fullPath;
-                    }
-                    // Check 3: Local dev folders
-                    const devPath = path.join(current, "tools", "XHSC", "dist");
-                    for (const name of candidates) {
-                        const fullPath = path.join(devPath, name);
-                        if (fs.existsSync(fullPath))
-                            return fullPath;
-                    }
-                    const parent = path.dirname(current);
-                    if (parent === current)
-                        break;
-                    current = parent;
-                }
-            }
-        }
-        catch (e) {
-            // Silently fall through to generic name
-        }
-        // Final fallback (generic name which might be in PATH)
+        const searchBases = [];
+        // 2. Add Script Directory (where the library is located)
+        const scriptDir = Discovery.Discovery.getScriptDir();
+        if (scriptDir)
+            searchBases.push(scriptDir);
+        // 3. Add Current Working Directory
+        searchBases.push(process.cwd());
+        // Perform recursive search from all bases using Discovery engine
+        const resolved = Discovery.Discovery.resolveBinary(candidates, searchBases);
+        if (resolved)
+            return resolved;
+        // Final fallback (generic name which might be in PATH via system spawn)
         return genericBinName;
     }
     /**

package/dist/cjs/src/xhsc/XyPrissRunner.js.map

@@ -1 +1 @@
-{"version":3,"file":"XyPrissRunner.js","sources":["../../../../src/xhsc/XyPrissRunner.ts"],"sourcesContent":[null],"names":["fileURLToPath","XHSC_SIGNATURE","execFileSync","spawn"],"mappings":"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"}
+{"version":3,"file":"XyPrissRunner.js","sources":["../../../../src/xhsc/XyPrissRunner.ts"],"sourcesContent":[null],"names":["Discovery","Platform","XHSC_SIGNATURE","execFileSync","spawn"],"mappings":"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"}

package/dist/cjs/src/xhsc/utils/Discovery.js

@@ -0,0 +1,114 @@
+'use strict';
+
+var path = require('node:path');
+var fs = require('node:fs');
+var node_url = require('node:url');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+/**
+ * **Discovery — XyPriss Resource & Binary Discovery Engine**
+ *
+ * This utility provides a robust, non-hardcoded mechanism for locating
+ * binaries and resources within the XyPriss ecosystem. It supports
+ * hierarchical searching, environment overrides, and system PATH resolution.
+ */
+class Discovery {
+    /**
+     * **Resolve a binary path**
+     *
+     * Searches for binary candidates in a set of base directories and their parents.
+     *
+     * @param candidates - List of potential binary names (in order of preference).
+     * @param searchBases - Root directories to start the search from.
+     * @param subDirs - Subdirectories to check within each base (defaults to STANDARD_PATHS).
+     * @returns The absolute path to the found binary, or null if not found.
+     */
+    static resolveBinary(candidates, searchBases, subDirs = Discovery.STANDARD_PATHS) {
+        for (const base of searchBases) {
+            let current = base;
+            // Traverse up to 8 levels to handle deeply nested node_modules or virtual stores
+            for (let depth = 0; depth < 8; depth++) {
+                for (const checkDir of subDirs) {
+                    const dir = path.join(current, checkDir);
+                    for (const name of candidates) {
+                        const fullPath = path.join(dir, name);
+                        try {
+                            if (fs.existsSync(fullPath))
+                                return fullPath;
+                        }
+                        catch {
+                            /* skip permission or access errors */
+                        }
+                    }
+                }
+                const parent = path.dirname(current);
+                if (parent === current)
+                    break;
+                current = parent;
+            }
+        }
+        // Final fallback: Manual scan of the system PATH
+        const pathEnv = process.env.PATH || "";
+        const delimiter = process.platform === "win32" ? ";" : ":";
+        const pathDirs = pathEnv.split(delimiter);
+        for (const dir of pathDirs) {
+            if (!dir)
+                continue;
+            for (const name of candidates) {
+                const fullPath = path.join(dir, name);
+                try {
+                    if (fs.existsSync(fullPath))
+                        return fullPath;
+                }
+                catch {
+                    /* skip */
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * **Get Script Directory**
+     *
+     * Robustly detects the directory of the currently executing script.
+     * Compatible with both CommonJS (__filename) and ESM (import.meta.url).
+     */
+    static getScriptDir() {
+        try {
+            // @ts-ignore
+            const _filename = typeof __filename !== "undefined"
+                ? __filename
+                : node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('src/xhsc/utils/Discovery.js', document.baseURI).href)));
+            return path.dirname(_filename);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * **Get Binary from Environment**
+     *
+     * Checks if a specific environment variable points to a valid binary path.
+     */
+    static getFromEnv(envVar) {
+        const val = process.env[envVar];
+        if (val && fs.existsSync(val))
+            return val;
+        return null;
+    }
+}
+/**
+ * **Standard XyPriss search subdirectories**
+ *
+ * These paths are checked relative to each parent directory during
+ * a hierarchical search.
+ */
+Discovery.STANDARD_PATHS = [
+    "bin",
+    path.join("node_modules", "xypriss", "bin"),
+    path.join("node_modules", ".bin"),
+    path.join("tools", "XHSC", "dist"),
+];
+
+exports.Discovery = Discovery;
+//# sourceMappingURL=Discovery.js.map

package/dist/cjs/src/xhsc/utils/Discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Discovery.js","sources":["../../../../../src/xhsc/utils/Discovery.ts"],"sourcesContent":[null],"names":["fileURLToPath"],"mappings":";;;;;;;AAIA;;;;;;AAMG;MACU,SAAS,CAAA;AAclB;;;;;;;;;AASG;IACI,OAAO,aAAa,CACvB,UAAoB,EACpB,WAAqB,EACrB,OAAA,GAAoB,SAAS,CAAC,cAAc,EAAA;AAE5C,QAAA,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE;YAC5B,IAAI,OAAO,GAAG,IAAI;;AAElB,YAAA,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE;AACpC,gBAAA,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE;oBAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC;AACxC,oBAAA,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE;wBAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC;AACrC,wBAAA,IAAI;AACA,4BAAA,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;AAAE,gCAAA,OAAO,QAAQ;wBAChD;AAAE,wBAAA,MAAM;;wBAER;oBACJ;gBACJ;gBAEA,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;gBACpC,IAAI,MAAM,KAAK,OAAO;oBAAE;gBACxB,OAAO,GAAG,MAAM;YACpB;QACJ;;QAGA,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE;AACtC,QAAA,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,GAAG,GAAG,GAAG,GAAG;QAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;AAEzC,QAAA,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE;AACxB,YAAA,IAAI,CAAC,GAAG;gBAAE;AACV,YAAA,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE;gBAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC;AACrC,gBAAA,IAAI;AACA,oBAAA,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;AAAE,wBAAA,OAAO,QAAQ;gBAChD;AAAE,gBAAA,MAAM;;gBAER;YACJ;QACJ;AAEA,QAAA,OAAO,IAAI;IACf;AAEA;;;;;AAKG;AACI,IAAA,OAAO,YAAY,GAAA;AACtB,QAAA,IAAI;;AAEA,YAAA,MAAM,SAAS,GACX,OAAO,UAAU,KAAK;AAClB,kBAAE;kBACAA,sBAAa,CAAC,6QAAe,CAAC;AACxC,YAAA,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;QAClC;AAAE,QAAA,MAAM;AACJ,YAAA,OAAO,IAAI;QACf;IACJ;AAEA;;;;AAIG;IACI,OAAO,UAAU,CAAC,MAAc,EAAA;QACnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;AAC/B,QAAA,IAAI,GAAG,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;AAAE,YAAA,OAAO,GAAG;AACzC,QAAA,OAAO,IAAI;IACf;;AAlGA;;;;;AAKG;AACoB,SAAA,CAAA,cAAc,GAAG;IACpC,KAAK;IACL,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,EAAE,KAAK,CAAC;AAC3C,IAAA,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC;IACjC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;CACrC;;;;"}

package/dist/cjs/src/xhsc/utils/Platform.js

@@ -0,0 +1,51 @@
+'use strict';
+
+/**
+ * **Platform — XyPriss Platform & Architecture Utilities**
+ *
+ * Provides normalized naming conventions for OS and CPU architectures
+ * used throughout the XyPriss ecosystem, specifically for binary resolution.
+ */
+class Platform {
+    /**
+     * **Get Normalized OS Part**
+     *
+     * Maps Node.js process.platform to XyPriss standard OS identifiers.
+     * @returns {'windows' | 'darwin' | 'linux'}
+     */
+    static getOsPart() {
+        switch (process.platform) {
+            case "win32":
+                return "windows";
+            case "darwin":
+                return "darwin";
+            default:
+                return "linux";
+        }
+    }
+    /**
+     * **Get Normalized Architecture Part**
+     *
+     * Maps Node.js process.arch to XyPriss standard architecture identifiers.
+     * @returns {'arm64' | 'amd64'}
+     */
+    static getArchPart() {
+        switch (process.arch) {
+            case "arm64":
+                return "arm64";
+            default:
+                return "amd64"; // Default to amd64/x64
+        }
+    }
+    /**
+     * **Get Binary Suffix**
+     *
+     * Returns '.exe' for Windows platforms, empty string otherwise.
+     */
+    static getBinarySuffix() {
+        return process.platform === "win32" ? ".exe" : "";
+    }
+}
+
+exports.Platform = Platform;
+//# sourceMappingURL=Platform.js.map

package/dist/cjs/src/xhsc/utils/Platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Platform.js","sources":["../../../../../src/xhsc/utils/Platform.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;AAKG;MACU,QAAQ,CAAA;AACjB;;;;;AAKG;AACI,IAAA,OAAO,SAAS,GAAA;AACnB,QAAA,QAAQ,OAAO,CAAC,QAAQ;AACpB,YAAA,KAAK,OAAO;AACR,gBAAA,OAAO,SAAS;AACpB,YAAA,KAAK,QAAQ;AACT,gBAAA,OAAO,QAAQ;AACnB,YAAA;AACI,gBAAA,OAAO,OAAO;;IAE1B;AAEA;;;;;AAKG;AACI,IAAA,OAAO,WAAW,GAAA;AACrB,QAAA,QAAQ,OAAO,CAAC,IAAI;AAChB,YAAA,KAAK,OAAO;AACR,gBAAA,OAAO,OAAO;AAClB,YAAA;gBACI,OAAO,OAAO,CAAC;;IAE3B;AAEA;;;;AAIG;AACI,IAAA,OAAO,eAAe,GAAA;AACzB,QAAA,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,GAAG,MAAM,GAAG,EAAE;IACrD;AACH;;;;"}

package/dist/esm/src/plugins/api/PluginAPI.js

@@ -1,8 +1,9 @@
+import { HOOK_ID_MAP, HOOK_METADATA } from '../const/PluginHookIds.js';
+
 /**
  * Plugin API
  * Public API for plugin management as documented in PLUGIN_SYSTEM_GUIDE.md
  */
-// ─── Internal State ──────────────────────────────────────────────────────────
 // ─── Blocked / Private members ───────────────────────────────────────────────
 /**
  * Methods that must never be accessible from outside the module.
@@ -111,6 +112,14 @@ class PluginAPI {
         assertNonEmptyString(Sys, "XyPriss Initialization Error: To create a plugin, you MUST provide the plugin's root path or its '__sys__' instance as the second argument to Plugin.create().\n" +
             "Example: return Plugin.create({ ... }, __sys__.__root__);");
         plugin.__root__ = Sys;
+        if (!plugin.name || typeof plugin.name !== "string") {
+            throw new Error(`XyPriss Plugin Error: "name" is missing or invalid.`);
+        }
+        for (const field of ["description", "version"]) {
+            if (!plugin[field] || typeof plugin[field] !== "string") {
+                throw new Error(`XyPriss Plugin Error: "${field}" is missing or invalid on plugin "${plugin.name}".`);
+            }
+        }
         return plugin;
     }
     /**
@@ -166,7 +175,84 @@ class PluginAPI {
         return {
             name: `void-plugin-${Math.random().toString(36).slice(2, 9)}`,
             version: "1.0.0",
+            description: "A void plugin for testing purposes.",
+        };
+    }
+    /**
+     * Performs a deep inspection of a plugin instance to identify and list all required
+     * cryptographic permissions based on implemented hooks.
+     *
+     * This utility is designed for developers to use during the preparation of their
+     * `package.json` manifest (`xfpm.permissions` field).
+     *
+     * @param plugin - The XyPriss plugin instance to inspect.
+     *
+     * @example
+     * ```typescript
+     * const myPlugin = Plugin.create({ ... }, __sys__.__root__);
+     * Plugin.inspect(myPlugin);
+     * ```
+     */
+    inspect(plugin) {
+        const header = `[XyPriss Plugin Inspector] ${plugin.name} v${plugin.version}`;
+        const line = "═".repeat(header.length);
+        const c = {
+            reset: "\x1b[0m",
+            bold: "\x1b[1m",
+            dim: "\x1b[2m",
+            cyan: "\x1b[36m",
+            green: "\x1b[32m",
+            yellow: "\x1b[33m",
+            red: "\x1b[31m",
+            gray: "\x1b[90m",
+            magenta: "\x1b[35m",
         };
+        console.log(`\n${c.cyan}${line}${c.reset}`);
+        console.log(`${c.bold}${c.cyan}${header}${c.reset}`);
+        console.log(`${c.cyan}${line}${c.reset}`);
+        console.log(`${c.bold}Project Root:${c.reset} ${c.gray}${plugin.__root__ || "Not Captured"}${c.reset}`);
+        console.log(`\n${c.magenta}${c.bold}Detected Hooks & Authorized Permission IDs:${c.reset}`);
+        Object.entries(plugin);
+        const hookKeys = Object.keys(HOOK_ID_MAP);
+        let foundCount = 0;
+        // List of privileged IDs that require explicit authorization
+        const privilegedIds = [
+            "PLG.MANAGEMENT.MANAGE_PLUGINS",
+            "XHS.PERM.LOGGING.CONSOLE_INTERCEPT",
+            "XHS.PERM.OPS.AUXILIARY_SERVER",
+            "XHS.PERM.ROUTING.BYPASS_NAMESPACE",
+            "XHS.PERM.ROUTING.OVERWRITE_PROTECTED",
+            "XHS.PERM.HTTP.GLOBAL_MIDDLEWARE",
+            "XHS.PERM.SECURITY.CONFIGS",
+            "XHS.PERM.SECURITY.SENSITIVE_DATA",
+            "XHS.HOOK.HTTP.REQUEST",
+            "XHS.HOOK.HTTP.RESPONSE",
+        ];
+        // DEEP SCAN: Check all known hook and permission keys
+        for (const key of hookKeys) {
+            const hookId = HOOK_ID_MAP[key];
+            const value = plugin[key];
+            // If the key exists on the plugin instance (function, boolean, array, etc.)
+            if (value !== undefined) {
+                foundCount++;
+                const meta = HOOK_METADATA[hookId];
+                const isPrivileged = privilegedIds.includes(hookId);
+                console.log(`\n  ${c.cyan}○${c.reset} ${c.bold}Hook/Capability:${c.reset} ${c.green}${key}${c.reset}`);
+                console.log(`    ${c.bold}ID:${c.reset}   ${c.yellow}${hookId}${c.reset} ${isPrivileged ? `${c.red}${c.bold}⚠️  [PRIVILEGED]${c.reset}` : ""}`);
+                if (meta) {
+                    console.log(`    ${c.gray}Role:${c.reset} ${meta.action}`);
+                    console.log(`    ${c.gray}Info:${c.reset} ${c.dim}${meta.description}${c.reset}`);
+                }
+            }
+        }
+        if (foundCount === 0) {
+            console.log(`\n  ${c.yellow}No hooks requiring special permissions were detected in this plugin.${c.reset}`);
+        }
+        else {
+            console.log(`\n${c.bold}${c.green}Summary: Found ${foundCount} required permissions.${c.reset}`);
+            console.log(`\n${c.bold}${c.cyan}TIP:${c.reset} Copy the IDs above into your package.json's ${c.bold}"xfpm.permissions"${c.reset} array.`);
+        }
+        console.log(`\n${c.cyan}${line}${c.reset}\n`);
     }
 }
 // ─── Proxy Shield ─────────────────────────────────────────────────────────────

package/dist/esm/src/plugins/api/PluginAPI.js.map

@@ -1 +1 @@
-{"version":3,"file":"PluginAPI.js","sources":["../../../../../src/plugins/api/PluginAPI.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"PluginAPI.js","sources":["../../../../../src/plugins/api/PluginAPI.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/src/xhsc/XyPrissRunner.js

@@ -1,8 +1,7 @@
-import path__default from 'node:path';
-import fs__default from 'node:fs';
 import { execFileSync, spawn } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
 import { XHSC_SIGNATURE } from '../server/const/XHSC_SIGNATURE.js';
+import { Platform } from './utils/Platform.js';
+import { Discovery } from './utils/Discovery.js';
 
 /**
  * Custom error class for XyPriss system operations.
@@ -45,73 +44,29 @@ class XyPrissRunner {
      * Prioritizes the high-performance Go implementation (XHSC-GO).
      */
     discoverBinary() {
-        const getOsPart = () => {
-            switch (process.platform) {
-                case "win32":
-                    return "windows";
-                case "darwin":
-                    return "darwin";
-                default:
-                    return "linux";
-            }
-        };
-        const getArchPart = () => {
-            switch (process.arch) {
-                case "arm64":
-                    return "arm64";
-                default:
-                    return "amd64"; // Default to amd64/x64
-            }
-        };
-        const osPart = getOsPart();
-        const archPart = getArchPart();
-        const suffix = osPart === "windows" ? ".exe" : "";
+        // 1. Environment Variable Override (Highest Priority)
+        const envPath = Discovery.getFromEnv("XYPRISS_XHSC_PATH");
+        if (envPath)
+            return envPath;
+        const osPart = Platform.getOsPart();
+        const archPart = Platform.getArchPart();
+        const suffix = Platform.getBinarySuffix();
         // Candidate names in order of preference
         const goBinName = `xhsc-${osPart}-${archPart}${suffix}`;
         const genericBinName = osPart === "windows" ? "xhsc.exe" : "xhsc";
         const candidates = [goBinName, genericBinName];
-        try {
-            // Get location of *this* file (compiled JS)
-            const __filename = fileURLToPath(import.meta.url);
-            const scriptDir = path__default.dirname(__filename);
-            // Bases for recursive search: script location and current working directory
-            const searchBases = [scriptDir, process.cwd()];
-            for (const base of searchBases) {
-                let current = base;
-                // Go up up to 8 levels to handle deeply nested node_modules / virtual_store
-                for (let depth = 0; depth < 8; depth++) {
-                    // Check 1: Standard bin/ at this level
-                    const binDir = path__default.join(current, "bin");
-                    for (const name of candidates) {
-                        const fullPath = path__default.join(binDir, name);
-                        if (fs__default.existsSync(fullPath))
-                            return fullPath;
-                    }
-                    // Check 2: node_modules/.bin (if we are at project/env root)
-                    const nodeModulesBin = path__default.join(current, "node_modules", ".bin");
-                    for (const name of candidates) {
-                        const fullPath = path__default.join(nodeModulesBin, name);
-                        if (fs__default.existsSync(fullPath))
-                            return fullPath;
-                    }
-                    // Check 3: Local dev folders
-                    const devPath = path__default.join(current, "tools", "XHSC", "dist");
-                    for (const name of candidates) {
-                        const fullPath = path__default.join(devPath, name);
-                        if (fs__default.existsSync(fullPath))
-                            return fullPath;
-                    }
-                    const parent = path__default.dirname(current);
-                    if (parent === current)
-                        break;
-                    current = parent;
-                }
-            }
-        }
-        catch (e) {
-            // Silently fall through to generic name
-        }
-        // Final fallback (generic name which might be in PATH)
+        const searchBases = [];
+        // 2. Add Script Directory (where the library is located)
+        const scriptDir = Discovery.getScriptDir();
+        if (scriptDir)
+            searchBases.push(scriptDir);
+        // 3. Add Current Working Directory
+        searchBases.push(process.cwd());
+        // Perform recursive search from all bases using Discovery engine
+        const resolved = Discovery.resolveBinary(candidates, searchBases);
+        if (resolved)
+            return resolved;
+        // Final fallback (generic name which might be in PATH via system spawn)
         return genericBinName;
     }
     /**

package/dist/esm/src/xhsc/XyPrissRunner.js.map

@@ -1 +1 @@
-{"version":3,"file":"XyPrissRunner.js","sources":["../../../../src/xhsc/XyPrissRunner.ts"],"sourcesContent":[null],"names":["path","fs"],"mappings":"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"}
+{"version":3,"file":"XyPrissRunner.js","sources":["../../../../src/xhsc/XyPrissRunner.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/src/xhsc/utils/Discovery.js

@@ -0,0 +1,111 @@
+import path__default from 'node:path';
+import fs__default from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+/**
+ * **Discovery — XyPriss Resource & Binary Discovery Engine**
+ *
+ * This utility provides a robust, non-hardcoded mechanism for locating
+ * binaries and resources within the XyPriss ecosystem. It supports
+ * hierarchical searching, environment overrides, and system PATH resolution.
+ */
+class Discovery {
+    /**
+     * **Resolve a binary path**
+     *
+     * Searches for binary candidates in a set of base directories and their parents.
+     *
+     * @param candidates - List of potential binary names (in order of preference).
+     * @param searchBases - Root directories to start the search from.
+     * @param subDirs - Subdirectories to check within each base (defaults to STANDARD_PATHS).
+     * @returns The absolute path to the found binary, or null if not found.
+     */
+    static resolveBinary(candidates, searchBases, subDirs = Discovery.STANDARD_PATHS) {
+        for (const base of searchBases) {
+            let current = base;
+            // Traverse up to 8 levels to handle deeply nested node_modules or virtual stores
+            for (let depth = 0; depth < 8; depth++) {
+                for (const checkDir of subDirs) {
+                    const dir = path__default.join(current, checkDir);
+                    for (const name of candidates) {
+                        const fullPath = path__default.join(dir, name);
+                        try {
+                            if (fs__default.existsSync(fullPath))
+                                return fullPath;
+                        }
+                        catch {
+                            /* skip permission or access errors */
+                        }
+                    }
+                }
+                const parent = path__default.dirname(current);
+                if (parent === current)
+                    break;
+                current = parent;
+            }
+        }
+        // Final fallback: Manual scan of the system PATH
+        const pathEnv = process.env.PATH || "";
+        const delimiter = process.platform === "win32" ? ";" : ":";
+        const pathDirs = pathEnv.split(delimiter);
+        for (const dir of pathDirs) {
+            if (!dir)
+                continue;
+            for (const name of candidates) {
+                const fullPath = path__default.join(dir, name);
+                try {
+                    if (fs__default.existsSync(fullPath))
+                        return fullPath;
+                }
+                catch {
+                    /* skip */
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * **Get Script Directory**
+     *
+     * Robustly detects the directory of the currently executing script.
+     * Compatible with both CommonJS (__filename) and ESM (import.meta.url).
+     */
+    static getScriptDir() {
+        try {
+            // @ts-ignore
+            const _filename = typeof __filename !== "undefined"
+                ? __filename
+                : fileURLToPath(import.meta.url);
+            return path__default.dirname(_filename);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * **Get Binary from Environment**
+     *
+     * Checks if a specific environment variable points to a valid binary path.
+     */
+    static getFromEnv(envVar) {
+        const val = process.env[envVar];
+        if (val && fs__default.existsSync(val))
+            return val;
+        return null;
+    }
+}
+/**
+ * **Standard XyPriss search subdirectories**
+ *
+ * These paths are checked relative to each parent directory during
+ * a hierarchical search.
+ */
+Discovery.STANDARD_PATHS = [
+    "bin",
+    path__default.join("node_modules", "xypriss", "bin"),
+    path__default.join("node_modules", ".bin"),
+    path__default.join("tools", "XHSC", "dist"),
+];
+
+export { Discovery };
+//# sourceMappingURL=Discovery.js.map

package/dist/esm/src/xhsc/utils/Discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Discovery.js","sources":["../../../../../src/xhsc/utils/Discovery.ts"],"sourcesContent":[null],"names":["path","fs"],"mappings":";;;;AAIA;;;;;;AAMG;MACU,SAAS,CAAA;AAclB;;;;;;;;;AASG;IACI,OAAO,aAAa,CACvB,UAAoB,EACpB,WAAqB,EACrB,OAAA,GAAoB,SAAS,CAAC,cAAc,EAAA;AAE5C,QAAA,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE;YAC5B,IAAI,OAAO,GAAG,IAAI;;AAElB,YAAA,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE;AACpC,gBAAA,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE;oBAC5B,MAAM,GAAG,GAAGA,aAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC;AACxC,oBAAA,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE;wBAC3B,MAAM,QAAQ,GAAGA,aAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC;AACrC,wBAAA,IAAI;AACA,4BAAA,IAAIC,WAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;AAAE,gCAAA,OAAO,QAAQ;wBAChD;AAAE,wBAAA,MAAM;;wBAER;oBACJ;gBACJ;gBAEA,MAAM,MAAM,GAAGD,aAAI,CAAC,OAAO,CAAC,OAAO,CAAC;gBACpC,IAAI,MAAM,KAAK,OAAO;oBAAE;gBACxB,OAAO,GAAG,MAAM;YACpB;QACJ;;QAGA,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE;AACtC,QAAA,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,GAAG,GAAG,GAAG,GAAG;QAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;AAEzC,QAAA,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE;AACxB,YAAA,IAAI,CAAC,GAAG;gBAAE;AACV,YAAA,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE;gBAC3B,MAAM,QAAQ,GAAGA,aAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC;AACrC,gBAAA,IAAI;AACA,oBAAA,IAAIC,WAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;AAAE,wBAAA,OAAO,QAAQ;gBAChD;AAAE,gBAAA,MAAM;;gBAER;YACJ;QACJ;AAEA,QAAA,OAAO,IAAI;IACf;AAEA;;;;;AAKG;AACI,IAAA,OAAO,YAAY,GAAA;AACtB,QAAA,IAAI;;AAEA,YAAA,MAAM,SAAS,GACX,OAAO,UAAU,KAAK;AAClB,kBAAE;kBACA,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;AACxC,YAAA,OAAOD,aAAI,CAAC,OAAO,CAAC,SAAS,CAAC;QAClC;AAAE,QAAA,MAAM;AACJ,YAAA,OAAO,IAAI;QACf;IACJ;AAEA;;;;AAIG;IACI,OAAO,UAAU,CAAC,MAAc,EAAA;QACnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;AAC/B,QAAA,IAAI,GAAG,IAAIC,WAAE,CAAC,UAAU,CAAC,GAAG,CAAC;AAAE,YAAA,OAAO,GAAG;AACzC,QAAA,OAAO,IAAI;IACf;;AAlGA;;;;;AAKG;AACoB,SAAA,CAAA,cAAc,GAAG;IACpC,KAAK;IACLD,aAAI,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,EAAE,KAAK,CAAC;AAC3C,IAAAA,aAAI,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC;IACjCA,aAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;CACrC;;;;"}

package/dist/esm/src/xhsc/utils/Platform.js

@@ -0,0 +1,49 @@
+/**
+ * **Platform — XyPriss Platform & Architecture Utilities**
+ *
+ * Provides normalized naming conventions for OS and CPU architectures
+ * used throughout the XyPriss ecosystem, specifically for binary resolution.
+ */
+class Platform {
+    /**
+     * **Get Normalized OS Part**
+     *
+     * Maps Node.js process.platform to XyPriss standard OS identifiers.
+     * @returns {'windows' | 'darwin' | 'linux'}
+     */
+    static getOsPart() {
+        switch (process.platform) {
+            case "win32":
+                return "windows";
+            case "darwin":
+                return "darwin";
+            default:
+                return "linux";
+        }
+    }
+    /**
+     * **Get Normalized Architecture Part**
+     *
+     * Maps Node.js process.arch to XyPriss standard architecture identifiers.
+     * @returns {'arm64' | 'amd64'}
+     */
+    static getArchPart() {
+        switch (process.arch) {
+            case "arm64":
+                return "arm64";
+            default:
+                return "amd64"; // Default to amd64/x64
+        }
+    }
+    /**
+     * **Get Binary Suffix**
+     *
+     * Returns '.exe' for Windows platforms, empty string otherwise.
+     */
+    static getBinarySuffix() {
+        return process.platform === "win32" ? ".exe" : "";
+    }
+}
+
+export { Platform };
+//# sourceMappingURL=Platform.js.map

package/dist/esm/src/xhsc/utils/Platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Platform.js","sources":["../../../../../src/xhsc/utils/Platform.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;AAKG;MACU,QAAQ,CAAA;AACjB;;;;;AAKG;AACI,IAAA,OAAO,SAAS,GAAA;AACnB,QAAA,QAAQ,OAAO,CAAC,QAAQ;AACpB,YAAA,KAAK,OAAO;AACR,gBAAA,OAAO,SAAS;AACpB,YAAA,KAAK,QAAQ;AACT,gBAAA,OAAO,QAAQ;AACnB,YAAA;AACI,gBAAA,OAAO,OAAO;;IAE1B;AAEA;;;;;AAKG;AACI,IAAA,OAAO,WAAW,GAAA;AACrB,QAAA,QAAQ,OAAO,CAAC,IAAI;AAChB,YAAA,KAAK,OAAO;AACR,gBAAA,OAAO,OAAO;AAClB,YAAA;gBACI,OAAO,OAAO,CAAC;;IAE3B;AAEA;;;;AAIG;AACI,IAAA,OAAO,eAAe,GAAA;AACzB,QAAA,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,GAAG,MAAM,GAAG,EAAE;IACrD;AACH;;;;"}

package/dist/index.d.ts

@@ -7427,7 +7427,7 @@ interface XyPrissPlugin {
     name: string;
     version: string;
     type?: string;
-    description?: string;
+    description: string;
     /**
      * @internal - Captured project root of the plugin.
      * Used for contract security verification.
@@ -11004,6 +11004,22 @@ declare class PluginAPI {
      * Useful for testing or conditional plugin slots.
      */
     void(): XyPrissPlugin;
+    /**
+     * Performs a deep inspection of a plugin instance to identify and list all required
+     * cryptographic permissions based on implemented hooks.
+     *
+     * This utility is designed for developers to use during the preparation of their
+     * `package.json` manifest (`xfpm.permissions` field).
+     *
+     * @param plugin - The XyPriss plugin instance to inspect.
+     *
+     * @example
+     * ```typescript
+     * const myPlugin = Plugin.create({ ... }, __sys__.__root__);
+     * Plugin.inspect(myPlugin);
+     * ```
+     */
+    inspect(plugin: XyPrissPlugin): void;
 }
 declare const Plugin: Readonly<Omit<PluginAPI, "register">>;
 

package/package.json

@@ -70,5 +70,5 @@
     },
     "type": "module",
     "types": "./dist/index.d.ts",
-    "version": "9.10.0"
+    "version": "9.10.2"
 }