unrag 0.2.1 → 0.2.2

package/dist/cli/index.js

@@ -578,6 +578,17 @@ async function initCommand(args) {
 import { outro as outro2 } from "@clack/prompts";
 import path6 from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
+
+// cli/lib/constants.ts
+var UNRAG_SITE_URL = (process.env.UNRAG_SITE_URL ?? process.env.UNRAG_DOCS_BASE_URL)?.trim() || "https://unrag.dev";
+var UNRAG_GITHUB_REPO_URL = "https://github.com/BetterStacks/unrag";
+function docsUrl(siteRelativePath) {
+  const p = siteRelativePath.startsWith("/") ? siteRelativePath : `/${siteRelativePath}`;
+  const base = UNRAG_SITE_URL.endsWith("/") ? UNRAG_SITE_URL : `${UNRAG_SITE_URL}/`;
+  return new URL(p.replace(/^\/+/, "/"), base).toString();
+}
+
+// cli/commands/add.ts
 var CONFIG_FILE2 = "unrag.json";
 var __filename3 = fileURLToPath2(import.meta.url);
 var __dirname3 = path6.dirname(__filename3);
@@ -589,7 +600,7 @@ var parseAddArgs = (args) => {
       out.yes = true;
       continue;
     }
-    if (!out.connector && !a.startsWith("-")) {
+    if (!out.connector && a && !a.startsWith("-")) {
       out.connector = a;
       continue;
     }
@@ -645,7 +656,7 @@ Available connectors: notion`);
     `Installed connector: ${connector}.`,
     "",
     `- Code: ${path6.join(config.installDir, "connectors", connector)}`,
-    `- Docs: /docs/connectors/${connector}`,
+    `- Docs: ${docsUrl(`/docs/connectors/${connector}`)}`,
     "",
     merged.changes.length > 0 ? `Added deps: ${merged.changes.map((c) => c.name).join(", ")}` : "Added deps: none",
     nonInteractive ? "" : "Tip: keep NOTION_TOKEN server-side only (env var)."
@@ -654,12 +665,51 @@ Available connectors: notion`);
 }
 
 // cli/run.ts
+function renderHelp() {
+  return [
+    "unrag — vendor-in RAG primitives (ingest/retrieve + adapters) into your repo.",
+    "",
+    "Usage:",
+    "  bunx unrag <command> [options]",
+    "  npx  unrag <command> [options]",
+    "",
+    "Commands:",
+    "  init                Install core files (config + store adapter templates)",
+    "  add <connector>     Install a connector (currently: notion)",
+    "  help                Show this help",
+    "",
+    "Global options:",
+    "  -h, --help           Show help",
+    "  -y, --yes            Non-interactive; accept defaults",
+    "",
+    "init options:",
+    "  --store <adapter>    drizzle | prisma | raw-sql",
+    "  --dir <path>         Install directory (alias: --install-dir)",
+    "  --alias <@name>      Import alias base (e.g. @unrag)",
+    "",
+    "Examples:",
+    "  bunx unrag init",
+    "  bunx unrag init --yes --store drizzle --dir lib/unrag --alias @unrag",
+    "  bunx unrag add notion --yes",
+    "",
+    "Docs:",
+    `  - Quickstart: ${docsUrl("/docs/getting-started/quickstart")}`,
+    `  - CLI:       ${docsUrl("/docs/reference/cli")}`,
+    `  - Notion:    ${docsUrl("/docs/connectors/notion")}`,
+    "",
+    "Repo:",
+    `  ${UNRAG_GITHUB_REPO_URL}`,
+    "",
+    "Tip:",
+    "  After `init`, open the generated unrag.md for schema + env vars (DATABASE_URL)."
+  ].join(`
+`);
+}
 async function run(argv) {
   const [, , command, ...rest] = argv;
   intro("unrag");
   if (!command || command === "help" || command === "--help" || command === "-h") {
-    outro3(["Usage:", "", "- unrag init", "- unrag add <connector>"].join(`
-`));
+    outro3(renderHelp());
     return;
   }
   if (command === "init") {
@@ -670,7 +720,8 @@ async function run(argv) {
     await addCommand(rest);
     return;
   }
-  outro3(`Unknown command: ${command}`);
+  outro3([`Unknown command: ${command}`, "", renderHelp()].join(`
+`));
   process.exitCode = 1;
 }
 

package/package.json

@@ -4,7 +4,7 @@
   "bin": {
     "unrag": "./dist/cli/index.js"
   },
-  "version": "0.2.1",
+  "version": "0.2.2",
   "private": false,
   "license": "Apache-2.0",
   "devDependencies": {