@forwardimpact/guide 0.1.10 → 0.1.13

package/bin/fit-guide.js

@@ -5,8 +5,8 @@
  * Conversational agent interface for the Guide knowledge platform.
  *
  * Usage:
- *   bunx fit-guide
- *   echo "Tell me about the company" | bunx fit-guide
+ *   npx fit-guide
+ *   echo "Tell me about the company" | npx fit-guide
  */
 
 import { resolve } from "path";
@@ -18,12 +18,13 @@ if (process.argv.includes("--help") || process.argv.includes("-h")) {
   console.log(`fit-guide — Conversational agent for the Guide knowledge platform
 
 Usage:
-  bunx fit-guide                   Start interactive conversation
-  bunx fit-guide --data=<path>     Specify framework data directory
-  echo "question" | bunx fit-guide Pipe a question directly
+  npx fit-guide                   Start interactive conversation
+  npx fit-guide --data=<path>     Specify framework data directory
+  echo "question" | npx fit-guide Pipe a question directly
 
 Options:
   --data=<path>   Path to framework data directory
+  --init          Generate secrets, .env, and config/config.json
   --help, -h      Show this help message
   --version, -v   Show version
 
@@ -43,6 +44,103 @@ if (process.argv.includes("--version") || process.argv.includes("-v")) {
   process.exit(0);
 }
 
+// --init flag (works without SERVICE_SECRET)
+if (process.argv.includes("--init")) {
+  const { generateJWT, generateSecret, getOrGenerateSecret, updateEnvFile } =
+    await import("@forwardimpact/libsecret");
+
+  const serviceSecret = generateSecret();
+  const jwtSecret = await getOrGenerateSecret("JWT_SECRET", () =>
+    generateSecret(32),
+  );
+  const jwtAnonKey = generateJWT(
+    {
+      iss: "supabase",
+      iat: Math.floor(Date.now() / 1000),
+      exp: Math.floor(Date.now() / 1000) + 10 * 365 * 24 * 60 * 60,
+      role: "anon",
+    },
+    jwtSecret,
+  );
+
+  await updateEnvFile("SERVICE_SECRET", serviceSecret);
+  await updateEnvFile("JWT_SECRET", jwtSecret);
+  await updateEnvFile("JWT_ANON_KEY", jwtAnonKey);
+
+  // Assign unique ports so services don't all bind to the default 3000
+  const serviceUrls = {
+    SERVICE_AGENT_URL: "grpc://localhost:3002",
+    SERVICE_MEMORY_URL: "grpc://localhost:3003",
+    SERVICE_LLM_URL: "grpc://localhost:3004",
+    SERVICE_VECTOR_URL: "grpc://localhost:3005",
+    SERVICE_GRAPH_URL: "grpc://localhost:3006",
+    SERVICE_TOOL_URL: "grpc://localhost:3007",
+    SERVICE_TRACE_URL: "grpc://localhost:3008",
+  };
+
+  for (const [key, url] of Object.entries(serviceUrls)) {
+    await updateEnvFile(key, url);
+  }
+
+  console.log("SERVICE_SECRET was updated in .env");
+  console.log("JWT_SECRET is set in .env");
+  console.log("JWT_ANON_KEY was updated in .env");
+  console.log("Service URLs written to .env (ports 3002–3008).");
+
+  // Generate config/config.json with minimal service tree
+  const configDir = resolve("config");
+  const configPath = resolve("config", "config.json");
+
+  try {
+    await fs.access(configPath);
+    console.log("config/config.json already exists, skipping.");
+  } catch {
+    await fs.mkdir(configDir, { recursive: true });
+
+    const config = {
+      init: {
+        log_dir: "data/logs",
+        shutdown_timeout: 3000,
+        services: [
+          {
+            name: "trace",
+            command: "node -e \"import('@forwardimpact/svctrace/server.js')\"",
+          },
+          {
+            name: "vector",
+            command: "node -e \"import('@forwardimpact/svcvector/server.js')\"",
+          },
+          {
+            name: "graph",
+            command: "node -e \"import('@forwardimpact/svcgraph/server.js')\"",
+          },
+          {
+            name: "llm",
+            command: "node -e \"import('@forwardimpact/svcllm/server.js')\"",
+          },
+          {
+            name: "memory",
+            command: "node -e \"import('@forwardimpact/svcmemory/server.js')\"",
+          },
+          {
+            name: "tool",
+            command: "node -e \"import('@forwardimpact/svctool/server.js')\"",
+          },
+          {
+            name: "agent",
+            command: "node -e \"import('@forwardimpact/svcagent/server.js')\"",
+          },
+        ],
+      },
+    };
+
+    await fs.writeFile(configPath, JSON.stringify(config, null, 2) + "\n");
+    console.log("config/config.json created with service configuration.");
+  }
+
+  process.exit(0);
+}
+
 // SERVICE_SECRET gate — provide onboarding instructions instead of a cryptic error
 if (!process.env.SERVICE_SECRET) {
   console.log(`fit-guide — Conversational agent for the Guide knowledge platform
@@ -54,12 +152,12 @@ services must be available:
 
 To get started:
 
-  1. Clone the monorepo and run: just rc-start
-  2. Set SERVICE_SECRET in your environment
-  3. Run: bunx fit-guide
+  1. Run: npx fit-guide --init
+  2. Start the service stack: npx fit-rc start
+  3. Run: npx fit-guide
 
 Documentation: https://www.forwardimpact.team/guide
-Run bunx fit-guide --help for CLI options.`);
+Run npx fit-guide --help for CLI options.`);
   process.exit(1);
 }
 
@@ -79,8 +177,8 @@ The agent maintains conversation context across multiple turns.
 
 **Examples:**
 
-    echo "Tell me about the company" | bunx fit-guide
-    printf "What is microservices?\\nWhat are the benefits?\\n" | bunx fit-guide`;
+    echo "Tell me about the company" | npx fit-guide
+    printf "What is microservices?\\nWhat are the benefits?\\n" | npx fit-guide`;
 
   // Parse --data flag from CLI args
   const dataArg = process.argv.find((a) => a.startsWith("--data="));
@@ -173,7 +271,7 @@ Error: ${err.message}
 Ensure all required services are running:
   agent, llm, memory, graph, vector, tool, trace, web
 
-For local development: just rc-start
+Start the service stack: npx fit-rc start
 Documentation: https://www.forwardimpact.team/guide`);
   process.exit(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/guide",
-  "version": "0.1.10",
+  "version": "0.1.13",
   "description": "Conversational agent for engineering framework guidance — How do I find my bearing?",
   "license": "Apache-2.0",
   "author": "D. Olsson <hi@senzilla.io>",
@@ -34,7 +34,9 @@
   },
   "dependencies": {
     "@forwardimpact/libcodegen": "^0.1.32",
+    "@forwardimpact/librc": "^0.1.16",
     "@forwardimpact/libconfig": "^0.1.58",
+    "@forwardimpact/libsecret": "^0.1.7",
     "@forwardimpact/librepl": "^0.1.0",
     "@forwardimpact/librpc": "^0.1.77",
     "@forwardimpact/libstorage": "^0.1.53",