@kentwynn/kgraph 0.1.1 → 0.1.3

package/dist/cli/help.d.ts

@@ -0,0 +1 @@
+export declare function renderRootHelp(useColor?: boolean): string;

package/dist/cli/help.js

@@ -0,0 +1,60 @@
+import { Chalk } from "chalk";
+import figlet from "figlet";
+export function renderRootHelp(useColor = supportsColor()) {
+    const theme = new Chalk({ level: useColor ? 3 : 0 });
+    const command = (name, description) => `  ${theme.green(name.padEnd(30))} ${description}`;
+    const logo = renderLogo();
+    return [
+        "",
+        theme.hex("#7dd3fc").bold(logo),
+        "",
+        `  ${theme.bold("KGraph")} ${theme.dim("Persistent repo intelligence for AI coding tools")}`,
+        "",
+        `  ${theme.hex("#c084fc")("Build a local knowledge layer that helps Codex, Copilot, Cursor,")}`,
+        `  ${theme.hex("#c084fc")("and Claude Code reuse repo structure, decisions, and debugging history.")}`,
+        "",
+        theme.bold("Usage"),
+        "  kgraph <command> [options]",
+        "",
+        theme.bold("Start"),
+        command("init", "Create .kgraph/ workspace"),
+        command("init --integrations codex,cursor", "Initialize and connect AI tools"),
+        "",
+        theme.bold("Workflows"),
+        command("scan", "Refresh file, symbol, import, and relationship maps"),
+        command("context \"auth token refresh\"", "Return compact context for an AI chat"),
+        command("update", "Process .kgraph/inbox Markdown cognition notes"),
+        "",
+        theme.bold("Integrations"),
+        command("integrate list", "Show configured AI tool integrations"),
+        command("integrate add codex copilot", "Write KGraph instructions for AI tools"),
+        command("integrate remove cursor", "Remove KGraph-managed instruction blocks"),
+        "",
+        theme.bold("Options"),
+        command("-V, --version", "Show version"),
+        command("-h, --help", "Show this help"),
+        "",
+        `${theme.yellow("Examples")}`,
+        "  kgraph init --integrations codex,copilot,cursor",
+        "  kgraph scan",
+        "  kgraph context \"blog admin token usage\" --json",
+        "",
+        theme.dim("Docs: https://github.com/kentwynn/KGraph#readme"),
+        ""
+    ].join("\n");
+}
+function renderLogo() {
+    try {
+        return figlet.textSync("KGraph", {
+            font: "ANSI Shadow",
+            horizontalLayout: "default",
+            verticalLayout: "default"
+        });
+    }
+    catch {
+        return "KGraph";
+    }
+}
+function supportsColor() {
+    return Boolean(process.stdout.isTTY) && process.env.NO_COLOR === undefined;
+}

package/dist/cli/index.js

@@ -1,16 +1,28 @@
 #!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 import { Command } from "commander";
 import { registerInitCommand } from "./commands/init.js";
 import { registerScanCommand } from "./commands/scan.js";
 import { registerUpdateCommand } from "./commands/update.js";
 import { registerContextCommand } from "./commands/context.js";
 import { registerIntegrateCommand } from "./commands/integrate.js";
+import { renderRootHelp } from "./help.js";
 export function createProgram() {
     const program = new Command();
     program
         .name("kgraph")
         .description("Persistent repo intelligence for AI coding assistants")
-        .version("0.1.0");
+        .version("0.1.2")
+        .addHelpText("beforeAll", renderRootHelp())
+        .helpOption(false);
+    program.option("-h, --help", "Show this help");
+    program.hook("preAction", (thisCommand) => {
+        if (thisCommand.opts().help) {
+            console.log(renderRootHelp());
+            process.exitCode = 0;
+        }
+    });
     registerInitCommand(program);
     registerScanCommand(program);
     registerUpdateCommand(program);
@@ -18,6 +30,23 @@ export function createProgram() {
     registerIntegrateCommand(program);
     return program;
 }
-if (import.meta.url === `file://${process.argv[1]}`) {
-    await createProgram().parseAsync(process.argv);
+if (isCliEntrypoint()) {
+    const program = createProgram();
+    if (process.argv.length <= 2 || process.argv.includes("-h") || process.argv.includes("--help")) {
+        console.log(renderRootHelp());
+    }
+    else {
+        await program.parseAsync(process.argv);
+    }
+}
+function isCliEntrypoint() {
+    if (!process.argv[1]) {
+        return false;
+    }
+    try {
+        return realpathSync(fileURLToPath(import.meta.url)) === realpathSync(process.argv[1]);
+    }
+    catch {
+        return import.meta.url === `file://${process.argv[1]}`;
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kentwynn/kgraph",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Persistent repo intelligence for AI coding assistants.",
   "type": "module",
   "bin": {
@@ -38,14 +38,16 @@
   },
   "homepage": "https://github.com/kentwynn/KGraph#readme",
   "dependencies": {
+    "chalk": "^5.6.2",
     "commander": "^12.1.0",
     "fast-glob": "^3.3.2",
+    "figlet": "^1.11.0",
+    "typescript": "^5.9.3",
     "yaml": "^2.5.1"
   },
   "devDependencies": {
     "@types/node": "^20.17.10",
     "tsx": "^4.19.2",
-    "typescript": "^5.7.2",
     "vitest": "^2.1.8"
   },
   "engines": {