create-guardio 0.0.5 → 0.0.7

package/index.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createInterface } from "node:readline";
-import { mkdir, writeFile, chmod } from "node:fs/promises";
+import { mkdir, writeFile } from "node:fs/promises";
 import { resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -21,33 +21,83 @@ function ask(question, defaultAnswer = "") {
   });
 }
 
+function askYesNo(question, defaultAnswer = "n") {
+  return ask(question + " (y/n)", defaultAnswer).then((a) =>
+    /^y(es)?|1$/i.test(a),
+  );
+}
+
 async function main() {
   console.log("\nCreate Guardio\n");
 
   const guardioDir = await ask("Guardio directory", "./mcp-server-gated");
   const guardioPath = resolve(process.cwd(), guardioDir);
 
-  const url = await ask("MCP server URL", "https://example.com/mcp");
+  // Servers: at least one, with name + URL
+  const servers = [];
+  let serverName = await ask("First MCP server name", "default");
+  let serverUrl = await ask("MCP server URL", "https://example.com/mcp");
+  servers.push({ name: serverName, type: "url", url: serverUrl });
+
+  while (await askYesNo("Add another MCP server?", "n")) {
+    serverName = await ask("MCP server name", "server-" + (servers.length + 1));
+    serverUrl = await ask("MCP server URL", "https://example.com/mcp");
+    servers.push({ name: serverName, type: "url", url: serverUrl });
+  }
+
   const portStr = await ask("Guardio HTTP server port", "3939");
   const port = parseInt(portStr, 10) || 3939;
 
+  const installDashboard = await askYesNo("Install dashboard?", "n");
+
+  // Built-in plugins: by category
+  console.log("\nPolicy plugins:");
+  console.log("  1) none");
+  console.log("  2) deny-tool-access");
+  console.log("  3) regex");
+  console.log("  4) both");
+  const policyChoice = await ask("Policy plugins (1-4)", "1");
+  const policyNum = parseInt(policyChoice, 10) || 1;
+  const policyPlugins = [];
+  if (policyNum === 2 || policyNum === 4) policyPlugins.push({ type: "policy", name: "deny-tool-access" });
+  if (policyNum === 3 || policyNum === 4) policyPlugins.push({ type: "policy", name: "regex" });
+
+  const useStorage = await askYesNo("Use storage and events (for dashboard / policy state)?", installDashboard ? "y" : "n");
+
+  const plugins = [...policyPlugins];
+  if (useStorage) {
+    console.log("  1) sqlite (local file)");
+    console.log("  2) postgres");
+    const storageBackend = await ask("Storage backend (1-2)", "1");
+    if (storageBackend === "2") {
+      const pgConnectionString = await ask(
+        "PostgreSQL connection string",
+        "postgresql://localhost:5432/guardio",
+      );
+      const pgConfig = { connectionString: pgConnectionString };
+      plugins.push({ type: "storage", name: "postgres", config: pgConfig });
+      plugins.push({ type: "eventSink", name: "postgres" });
+      plugins.push({ type: "eventSinkStore", name: "postgres" });
+    } else {
+      const sqliteConfig = { database: "guardio.sqlite" };
+      plugins.push({ type: "storage", name: "sqlite", config: sqliteConfig });
+      plugins.push({ type: "eventSink", name: "sqlite", config: sqliteConfig });
+      plugins.push({ type: "eventSinkStore", name: "sqlite", config: sqliteConfig });
+    }
+  }
+
+  const addExamplePlugin = await askYesNo("Add example custom policy plugin?", "n");
+  if (addExamplePlugin) {
+    plugins.push({ type: "policy", name: "example", path: "./plugins/example" });
+  }
+
   const config = {
-    server: { type: "url", url },
-    client: { mode: "http", port, host: "127.0.0.1" },
-    plugins: [
-      { type: "policy", name: "default", config: { blockedTools: [] } },
-      {
-        type: "policy",
-        name: "example",
-        path: "./plugins/example",
-        config: {},
-      },
-    ],
+    servers,
+    client: { port, host: "127.0.0.1" },
+    plugins,
   };
 
   await mkdir(guardioPath, { recursive: true });
-  await mkdir(resolve(guardioPath, "bin"), { recursive: true });
-  await mkdir(resolve(guardioPath, "plugins", "example"), { recursive: true });
 
   const packageJson = {
     name: "guardio-project",
@@ -56,14 +106,20 @@ async function main() {
     description: "Guardio-gated MCP server with optional local plugins",
     scripts: {
       build: "tsc",
-      guardio: "node bin/guardio.mjs",
+      guardio:
+        "node --import tsx ./node_modules/@guardiojs/guardio/dist/cli.js --config guardio.config.ts",
     },
     dependencies: { "@guardiojs/guardio": "*" },
     devDependencies: {
       typescript: "^5.6.0",
       "@types/node": "^22.0.0",
+      tsx: "^4.19.0",
     },
   };
+  if (installDashboard) {
+    packageJson.dependencies["@guardiojs/dashboard"] = "*";
+    packageJson.scripts.dashboard = "guardio-dashboard";
+  }
   await writeFile(
     resolve(guardioPath, "package.json"),
     JSON.stringify(packageJson, null, 2),
@@ -99,25 +155,9 @@ export default config;
     "utf-8",
   );
 
-  const binContent = `#!/usr/bin/env node
-import { spawnSync } from "child_process";
-import path from "path";
-import { fileURLToPath } from "url";
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const configPath = path.resolve(__dirname, "..", "guardio.config.ts");
-const result = spawnSync(
-  "npx",
-  ["-y", "@guardiojs/guardio", "--config", configPath],
-  { stdio: "inherit" }
-);
-process.exit(result.status ?? 1);
-`;
-
-  const binPath = resolve(guardioPath, "bin", "guardio.mjs");
-  await writeFile(binPath, binContent, "utf-8");
-  await chmod(binPath, 0o755);
-
-  const examplePluginContent = `import type {
+  if (addExamplePlugin) {
+    await mkdir(resolve(guardioPath, "plugins", "example"), { recursive: true });
+    const examplePluginContent = `import type {
   PolicyPluginInterface,
   PolicyRequestContext,
   PolicyResult,
@@ -133,30 +173,29 @@ class ExamplePolicyPlugin implements PolicyPluginInterface {
 
   evaluate(context: PolicyRequestContext): PolicyResult {
     // Example: allow all calls. Replace with your policy logic.
-    return "allowed";
+    return { verdict: "allow" };
   }
 }
 
 export default new ExamplePolicyPlugin();
 `;
+    await writeFile(
+      resolve(guardioPath, "plugins", "example", "index.ts"),
+      examplePluginContent,
+      "utf-8",
+    );
+  }
 
-  await writeFile(
-    resolve(guardioPath, "plugins", "example", "index.ts"),
-    examplePluginContent,
-    "utf-8",
-  );
-
+  await mkdir(resolve(guardioPath, "plugins"), { recursive: true });
   const pluginsReadme = `# Custom plugins (path-based)
 
 Add a plugin by setting \`path\` in \`guardio.config.ts\` to a directory that contains \`index.js\` or \`index.mjs\` (compile from \`index.ts\` with \`npm run build\`).
 
 - The directory must have \`index.js\` or \`index.mjs\` whose **default export is the plugin instance** (no descriptor).
 - Policy: implement \`PolicyPluginInterface\` (name, evaluate). Config: \`{ "type": "policy", "name": "my-policy", "path": "./plugins/my-policy" }\`.
-- Intervention: implement \`InterventionPluginInterface\` (name, act). Config: \`{ "type": "intervention", "name": "my-intervention", "path": "./plugins/my-intervention" }\`.
 
-Import types from "@guardiojs/guardio". See example/ for a policy plugin.
+Import types from "@guardiojs/guardio".${addExamplePlugin ? " See example/ for a policy plugin." : ""}
 `;
-
   await writeFile(
     resolve(guardioPath, "plugins", "README.md"),
     pluginsReadme,
@@ -166,11 +205,19 @@ Import types from "@guardiojs/guardio". See example/ for a policy plugin.
   console.log("\n---\n");
   console.log("Next steps");
   console.log("  cd " + guardioDir + " && npm install");
-  console.log("  npm run build   # compile plugins (index.ts → index.js)");
+  if (addExamplePlugin) {
+    console.log("  npm run build   # compile plugins (index.ts → index.js)");
+  }
   console.log("");
   console.log("Run Guardio as HTTP server:");
-  console.log("  guardio --config guardio.config.ts");
+  console.log("  npm run guardio");
   console.log("");
+  if (installDashboard) {
+    console.log("Run dashboard (point it at Guardio URL):");
+    console.log("  npm run dashboard");
+    console.log("  # Dashboard needs Guardio base URL, e.g. http://127.0.0.1:" + port);
+    console.log("");
+  }
   console.log("Add to MCP client (use URL):");
   console.log('  "url": "http://127.0.0.1:' + port + '"');
   console.log("");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-guardio",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "Scaffold a Guardio project",
   "type": "module",
   "bin": {