@forwardimpact/guide 0.1.5 → 0.1.8

package/bin/fit-guide.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env bun
+#!/usr/bin/env node
 /**
  * fit-guide CLI
  *
@@ -54,7 +54,7 @@ services must be available:
 
 To get started:
 
-  1. Clone the monorepo and run: make services
+  1. Clone the monorepo and run: just rc-start
   2. Set SERVICE_SECRET in your environment
   3. Run: bunx fit-guide
 
@@ -63,15 +63,16 @@ Run bunx fit-guide --help for CLI options.`);
   process.exit(1);
 }
 
-import { createServiceConfig } from "@forwardimpact/libconfig";
-import { Repl } from "@forwardimpact/librepl";
-import { createClient, createTracer } from "@forwardimpact/librpc";
-import { createLogger } from "@forwardimpact/libtelemetry";
-import { agent, common } from "@forwardimpact/libtype";
-import { createStorage } from "@forwardimpact/libstorage";
-import { Finder } from "@forwardimpact/libutil";
+try {
+  const { createServiceConfig } = await import("@forwardimpact/libconfig");
+  const { Repl } = await import("@forwardimpact/librepl");
+  const { createClient, createTracer } = await import("@forwardimpact/librpc");
+  const { createLogger } = await import("@forwardimpact/libtelemetry");
+  const { agent, common } = await import("@forwardimpact/libtype");
+  const { createStorage } = await import("@forwardimpact/libstorage");
+  const { Finder } = await import("@forwardimpact/libutil");
 
-const usage = `**Usage:** <message>
+  const usage = `**Usage:** <message>
 
 Send conversational messages to the Agent service for processing.
 The agent maintains conversation context across multiple turns.
@@ -81,24 +82,23 @@ The agent maintains conversation context across multiple turns.
     echo "Tell me about the company" | bunx fit-guide
     printf "What is microservices?\\nWhat are the benefits?\\n" | bunx fit-guide`;
 
-// Parse --data flag from CLI args
-const dataArg = process.argv.find((a) => a.startsWith("--data="));
-let dataDir;
-if (dataArg) {
-  dataDir = resolve(dataArg.slice(7));
-} else {
-  const guideLogger = createLogger("cli");
-  const finder = new Finder(fs, guideLogger, process);
-  try {
-    dataDir = finder.findData("data", homedir());
-  } catch {
-    throw new Error(
-      "No data directory found. Use --data=<path> to specify location.",
-    );
+  // Parse --data flag from CLI args
+  const dataArg = process.argv.find((a) => a.startsWith("--data="));
+  let dataDir;
+  if (dataArg) {
+    dataDir = resolve(dataArg.slice(7));
+  } else {
+    const guideLogger = createLogger("cli");
+    const finder = new Finder(fs, guideLogger, process);
+    try {
+      dataDir = finder.findData("data", homedir());
+    } catch {
+      throw new Error(
+        "No data directory found. Use --data=<path> to specify location.",
+      );
+    }
   }
-}
 
-try {
   const config = await createServiceConfig("agent");
   const logger = createLogger("cli");
   const tracer = await createTracer("cli");
@@ -173,7 +173,7 @@ Error: ${err.message}
 Ensure all required services are running:
   agent, llm, memory, graph, vector, tool, trace, web
 
-For local development: make services
+For local development: just rc-start
 Documentation: https://www.forwardimpact.team/guide`);
   process.exit(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/guide",
-  "version": "0.1.5",
+  "version": "0.1.8",
   "description": "Conversational agent for engineering framework guidance — How do I find my bearing?",
   "license": "Apache-2.0",
   "author": "D. Olsson <hi@senzilla.io>",
@@ -25,11 +25,11 @@
     "fit-guide": "./bin/fit-guide.js"
   },
   "files": [
-    "bin/",
-    "README.md"
+    "bin/"
   ],
   "engines": {
-    "bun": ">=1.2.0"
+    "bun": ">=1.2.0",
+    "node": ">=18.0.0"
   },
   "dependencies": {
     "@forwardimpact/libconfig": "^0.1.58",

package/README.md

@@ -1,94 +0,0 @@
-# @forwardimpact/guide
-
-> How do I find my bearing?
-
-Guide is an AI agent that understands your organization's engineering framework
-— skills, levels, behaviours, and expectations — and reasons about them in
-context. It helps developers onboard, find growth areas, and interpret
-engineering artifacts against skill markers.
-
-Guide is part of the [Forward Impact](https://www.forwardimpact.team) product
-suite alongside [Map](https://www.npmjs.com/package/@forwardimpact/map),
-[Pathway](https://www.npmjs.com/package/@forwardimpact/pathway), Basecamp,
-Landmark, and Summit.
-
-## Install
-
-```sh
-bun install @forwardimpact/guide
-```
-
-## Service Requirements
-
-Guide is a client for the Forward Impact knowledge platform. Unlike Map (local
-YAML validation) and Pathway (local job derivation), Guide connects to a gRPC
-service stack for LLM orchestration, memory, knowledge graphs, and vector
-search.
-
-The following services must be running:
-
-- **agent** — orchestrates multi-turn conversations
-- **llm** — provides LLM completions
-- **memory** — manages conversation history
-- **graph** — stores knowledge graph triples
-- **vector** — provides embedding similarity search
-- **tool** — executes tool calls
-- **trace** — records execution traces
-- **web** — serves web interface
-
-## Quick Start
-
-1. Clone the monorepo and start the service stack:
-
-   ```sh
-   git clone https://github.com/forwardimpact/monorepo
-   cd monorepo
-   make services
-   ```
-
-2. Set the service secret in your environment:
-
-   ```sh
-   export SERVICE_SECRET=<your-secret>
-   ```
-
-3. Run Guide:
-
-   ```sh
-   bunx fit-guide
-   ```
-
-## CLI Usage
-
-```sh
-# Start an interactive conversation
-bunx fit-guide
-
-# Pipe a question directly
-echo "Tell me about the company" | bunx fit-guide
-
-# Specify a framework data directory
-bunx fit-guide --data=./my-data
-
-# Show help
-bunx fit-guide --help
-
-# Show version
-bunx fit-guide --version
-```
-
-## Related Packages
-
-- [@forwardimpact/map](https://www.npmjs.com/package/@forwardimpact/map) —
-  Engineering framework validation and data product
-- [@forwardimpact/pathway](https://www.npmjs.com/package/@forwardimpact/pathway)
-  — Career progression web app and CLI
-
-## Documentation
-
-- [Guide product page](https://www.forwardimpact.team/guide)
-- [Monorepo](https://github.com/forwardimpact/monorepo)
-
-## License
-
-Apache-2.0