@graphit/cli 0.1.0

package/dist/commands/setup.js

@@ -0,0 +1,173 @@
+import { existsSync, readdirSync } from "node:fs";
+import { readFile, writeFile, mkdir, copyFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+import { execFileSync } from "node:child_process";
+import { readCredentials } from "../auth/credentials.js";
+function resolveSkillDir() {
+    const fromDist = join(dirname(new URL(import.meta.url).pathname), "..", "..", "skill");
+    if (existsSync(join(fromDist, "SKILL.md")))
+        return fromDist;
+    return join(dirname(dirname(dirname(import.meta.url.replace("file://", "")))), "skill");
+}
+function detectEditors() {
+    const editors = [];
+    if (existsSync(".claude") || commandExists("claude"))
+        editors.push("claude-code");
+    if (existsSync(".cursor"))
+        editors.push("cursor");
+    if (existsSync(".codex") || commandExists("codex"))
+        editors.push("codex");
+    if (existsSync(".vscode"))
+        editors.push("vscode");
+    return editors;
+}
+function commandExists(cmd) {
+    try {
+        execFileSync("which", [cmd], { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function getInstallTargets(editors, project, skillMd, cursorMdc) {
+    const targets = [];
+    const home = homedir();
+    for (const editor of editors) {
+        switch (editor) {
+            case "claude-code": {
+                const base = project
+                    ? join(".claude", "skills", "graphit")
+                    : join(home, ".claude", "skills", "graphit");
+                targets.push({
+                    editor,
+                    path: join(base, "SKILL.md"),
+                    content: skillMd,
+                    refsDir: join(base, "references"),
+                });
+                break;
+            }
+            case "codex": {
+                const base = project
+                    ? join(".codex", "skills", "graphit")
+                    : join(home, ".codex", "skills", "graphit");
+                targets.push({
+                    editor,
+                    path: join(base, "SKILL.md"),
+                    content: skillMd,
+                    refsDir: join(base, "references"),
+                });
+                break;
+            }
+            case "cursor":
+                targets.push({
+                    editor,
+                    path: project
+                        ? join(".cursor", "rules", "graphit.mdc")
+                        : join(home, ".cursor", "rules", "graphit.mdc"),
+                    content: cursorMdc,
+                });
+                break;
+            case "vscode":
+                if (project) {
+                    targets.push({ editor, path: "AGENTS.md", content: skillMd });
+                }
+                break;
+        }
+    }
+    return targets;
+}
+async function installReferences(sourceRefsDir, targetRefsDir, update) {
+    if (!existsSync(sourceRefsDir))
+        return [];
+    const files = readdirSync(sourceRefsDir).filter((f) => f.endsWith(".md"));
+    if (files.length === 0)
+        return [];
+    await mkdir(targetRefsDir, { recursive: true });
+    const written = [];
+    for (const file of files) {
+        const targetPath = join(targetRefsDir, file);
+        if (existsSync(targetPath) && !update)
+            continue;
+        if (existsSync(targetPath) && update) {
+            await copyFile(targetPath, `${targetPath}.bak`);
+        }
+        const content = await readFile(join(sourceRefsDir, file), "utf-8");
+        await writeFile(targetPath, content, "utf-8");
+        written.push(targetPath);
+    }
+    return written;
+}
+export function registerSetupCommand(program) {
+    program
+        .command("setup")
+        .description("Install Graphit skill for your AI coding assistant")
+        .option("--editor <name>", "Override editor detection (claude-code, cursor, codex, vscode)")
+        .option("--project", "Install at project level (in repo, committable)")
+        .option("--update", "Overwrite existing skill files")
+        .option("--dry-run", "Show what would be installed without writing")
+        .action(async function () {
+        const opts = this.opts();
+        const creds = await readCredentials();
+        if (!creds) {
+            console.log("Warning: Not logged in. Run `graphit auth login` first for full functionality.\n");
+        }
+        let editors;
+        if (opts.editor) {
+            editors = [opts.editor];
+        }
+        else {
+            editors = detectEditors();
+            if (editors.length === 0) {
+                console.error(JSON.stringify({
+                    error: "No supported editor detected. Use --editor to specify one.",
+                }));
+                process.exit(1);
+            }
+        }
+        const skillDir = resolveSkillDir();
+        const skillMd = await readFile(join(skillDir, "SKILL.md"), "utf-8");
+        const cursorMdc = await readFile(join(skillDir, "graphit.mdc"), "utf-8");
+        const sourceRefsDir = join(skillDir, "references");
+        const targets = getInstallTargets(editors, !!opts.project, skillMd, cursorMdc);
+        if (targets.length === 0) {
+            console.error(JSON.stringify({ error: "No install targets found." }));
+            process.exit(1);
+        }
+        if (opts.dryRun) {
+            console.log("Dry run - would install:\n");
+            for (const t of targets) {
+                console.log(`  ${t.editor}: ${t.path}`);
+                if (t.refsDir && existsSync(sourceRefsDir)) {
+                    const refs = readdirSync(sourceRefsDir).filter((f) => f.endsWith(".md"));
+                    refs.forEach((r) => console.log(`  ${t.editor}: ${join(t.refsDir, r)}`));
+                }
+            }
+            return;
+        }
+        for (const target of targets) {
+            if (existsSync(target.path) && !opts.update) {
+                console.log(`Skill file already exists at ${target.path}. Use --update to overwrite.`);
+                continue;
+            }
+            if (existsSync(target.path) && opts.update) {
+                await copyFile(target.path, `${target.path}.bak`);
+            }
+            await mkdir(dirname(target.path), { recursive: true });
+            await writeFile(target.path, target.content, "utf-8");
+            console.log(`Written: ${target.path}`);
+            if (target.refsDir) {
+                const refFiles = await installReferences(sourceRefsDir, target.refsDir, !!opts.update);
+                if (refFiles.length > 0) {
+                    console.log(`Written: ${refFiles.length} reference files to ${target.refsDir}/`);
+                }
+            }
+        }
+        const mode = opts.project ? "project" : "global";
+        const editorNames = editors.join(", ");
+        console.log(`\nGraphit skill installed for ${editorNames} (${mode}).`);
+        console.log('\nTry: "Explore the Graphit KB and build a revenue dashboard"');
+    });
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { registerAuthCommands } from "./commands/auth.js";
+import { registerKBCommands } from "./commands/kb.js";
+import { registerQueryCommands } from "./commands/query.js";
+import { registerDSCommands } from "./commands/ds.js";
+import { registerDashboardCommands } from "./commands/dashboard.js";
+import { registerConnectorCommands } from "./commands/connector.js";
+import { registerSetupCommand } from "./commands/setup.js";
+const program = new Command();
+program
+    .name("graphit")
+    .description("Graphit CLI - Build custom dashboards from any AI coding assistant")
+    .version("0.1.0")
+    .option("--output <format>", "Output format: json (default) or table", "json");
+registerAuthCommands(program);
+registerKBCommands(program);
+registerQueryCommands(program);
+registerDSCommands(program);
+registerDashboardCommands(program);
+registerConnectorCommands(program);
+registerSetupCommand(program);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,oEAAoE,CAAC;KACjF,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,mBAAmB,EAAE,wCAAwC,EAAE,MAAM,CAAC,CAAC;AAEjF,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,yBAAyB,CAAC,OAAO,CAAC,CAAC;AACnC,yBAAyB,CAAC,OAAO,CAAC,CAAC;AACnC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAE9B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/output/format.d.ts

@@ -0,0 +1,8 @@
+import { Command } from "commander";
+export type OutputFormat = "json" | "table";
+export declare function getOutputFormat(cmd: Command): OutputFormat;
+export declare function output(cmd: Command, data: unknown, opts?: {
+    columns?: string[];
+    keyValue?: boolean;
+}): void;
+export declare function errorOutput(err: unknown): void;

package/dist/output/format.js

@@ -0,0 +1,30 @@
+import { formatJson } from "./json.js";
+import { formatTable, formatKeyValue } from "./table.js";
+export function getOutputFormat(cmd) {
+    const root = cmd.parent ?? cmd;
+    const format = root.opts().output;
+    return format === "table" ? "table" : "json";
+}
+export function output(cmd, data, opts) {
+    const format = getOutputFormat(cmd);
+    if (format === "json") {
+        console.log(formatJson(data));
+        return;
+    }
+    if (opts?.keyValue && !Array.isArray(data)) {
+        console.log(formatKeyValue(data));
+        return;
+    }
+    const rows = Array.isArray(data) ? data : [data];
+    console.log(formatTable(rows, opts?.columns));
+}
+export function errorOutput(err) {
+    const message = err instanceof Error
+        ? err.message
+        : typeof err === "object" && err !== null && "detail" in err
+            ? err.detail
+            : String(err);
+    console.error(JSON.stringify({ error: message }));
+    process.exit(1);
+}
+//# sourceMappingURL=format.js.map

package/dist/output/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/output/format.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIzD,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,MAAgB,CAAC;IAC5C,OAAO,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,MAAM,CACpB,GAAY,EACZ,IAAa,EACb,IAAiD;IAEjD,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAEpC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,IAAI,IAAI,EAAE,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAA+B,CAAC,CAAC,CAAC;QAC7D,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAiC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,MAAM,OAAO,GACX,GAAG,YAAY,KAAK;QAClB,CAAC,CAAC,GAAG,CAAC,OAAO;QACb,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,QAAQ,IAAI,GAAG;YAC1D,CAAC,CAAE,GAA0B,CAAC,MAAM;YACpC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAEpB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/output/json.d.ts

@@ -0,0 +1 @@
+export declare function formatJson(data: unknown): string;

package/dist/output/json.js

@@ -0,0 +1,4 @@
+export function formatJson(data) {
+    return JSON.stringify(data, null, 2);
+}
+//# sourceMappingURL=json.js.map

package/dist/output/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/output/json.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/dist/output/table.d.ts

@@ -0,0 +1,2 @@
+export declare function formatTable(rows: Record<string, unknown>[], columns?: string[]): string;
+export declare function formatKeyValue(data: Record<string, unknown>): string;

package/dist/output/table.js

@@ -0,0 +1,17 @@
+export function formatTable(rows, columns) {
+    if (rows.length === 0)
+        return "(no results)";
+    const cols = columns || Object.keys(rows[0]);
+    const widths = cols.map((col) => Math.max(col.length, ...rows.map((r) => String(r[col] ?? "").length)));
+    const header = cols.map((col, i) => col.padEnd(widths[i])).join("  ");
+    const separator = widths.map((w) => "-".repeat(w)).join("  ");
+    const body = rows.map((row) => cols.map((col, i) => String(row[col] ?? "").padEnd(widths[i])).join("  "));
+    return [header, separator, ...body].join("\n");
+}
+export function formatKeyValue(data) {
+    const maxKeyLen = Math.max(...Object.keys(data).map((k) => k.length));
+    return Object.entries(data)
+        .map(([k, v]) => `${k.padEnd(maxKeyLen)}  ${v}`)
+        .join("\n");
+}
+//# sourceMappingURL=table.js.map

package/dist/output/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../src/output/table.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CACzB,IAA+B,EAC/B,OAAkB;IAElB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC;IAE7C,MAAM,IAAI,GAAG,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAC9B,IAAI,CAAC,GAAG,CACN,GAAG,CAAC,MAAM,EACV,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAChD,CACF,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAC5B,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC1E,CAAC;IAEF,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAA6B;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACtE,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;SAC/C,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@graphit/cli",
+  "version": "0.1.0",
+  "description": "Graphit CLI - Build custom dashboards from any AI coding assistant",
+  "type": "module",
+  "bin": {
+    "graphit": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "lint": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "skill"
+  ],
+  "keywords": [
+    "graphit",
+    "bi",
+    "dashboard",
+    "cli",
+    "ai"
+  ],
+  "license": "UNLICENSED",
+  "dependencies": {
+    "commander": "^13.0.0",
+    "open": "^10.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0"
+  }
+}

package/skill/SKILL.md

@@ -0,0 +1,163 @@
+---
+name: graphit
+description: >
+  Build HTML dashboards with Graphit. KB-aware queries, entity wrapping, cached data sources.
+  Triggers on: "dashboard", "graphit", "KB", "metric", "data source", "build a dashboard",
+  "explore the KB", "query data", "custom dashboard".
+version: "0.4.0"
+---
+
+# Graphit CLI
+
+Build custom HTML dashboards from real data using the Graphit CLI.
+
+## HARD CONSTRAINTS (violating these produces a broken dashboard)
+
+### 1. ZERO external resources
+The dashboard renders in a sandboxed iframe with a strict CSP. External requests are BLOCKED.
+Your HTML must NEVER contain:
+- `<script src="...">` - no Chart.js, D3.js, Alpine.js, ANY external JS
+- `<link href="...">` - no Tailwind CDN, Google Fonts, ANY external CSS
+- `<img src="https://...">` - no external images
+
+If you use ANY `src=` or `href=` pointing to a URL, the dashboard will be blank.
+Build charts with: CSS width% bars, inline SVG paths, or `<canvas>` with inline drawing code.
+All CSS in `<style>`, all JS in `<script>`, all fonts from system stack.
+
+### 2. ALWAYS query through data sources
+NEVER query the warehouse directly when a cached data source covers the table. Data sources return in ~100ms. Warehouse queries take ~10s and cost Snowflake credits.
+
+**Before writing ANY query:**
+1. Run `graphit ds list` to see what data sources exist
+2. If a DS covers your table, use `graphit query "SQL" --ds <id>` (DuckDB syntax)
+3. Only use `graphit query "SQL" --warehouse --connection <id>` if NO data source exists and the user approves
+
+**Wrong:** Jumping straight to `graphit query "SELECT SUM(cost) FROM marketing_ua" --warehouse` when a data source already caches that table.
+**Right:** `graphit ds list` first, find the DS ID, then `graphit query "SELECT SUM(cost) FROM marketing_ua" --ds ds_abc123`.
+
+### 3. EVERY element must have entity wrapping
+Without `data-graphit-*` attributes, elements are invisible to the platform - no click info, no mentions, no KB provenance. Every chart, KPI card, table, and text section needs ALL FOUR attributes:
+
+```html
+<div data-graphit-id="revenue-trend"
+     data-graphit-label="Revenue Trend"
+     data-graphit-kb="metric:REVENUE,dimension:REGION,table:ORDERS"
+     data-graphit-sql="SELECT region, SUM(revenue) FROM orders GROUP BY region">
+  <!-- chart/KPI/table content here -->
+</div>
+```
+
+| Attribute | Format | Example |
+|-----------|--------|---------|
+| `data-graphit-id` | Unique kebab-case | `"spend-by-source"` |
+| `data-graphit-label` | Human-readable name | `"Ad Spend by Source"` |
+| `data-graphit-kb` | `type:NAME` comma-separated | `"metric:CPI,dimension:MEDIA_SOURCE,table:MARKETING_UA"` |
+| `data-graphit-sql` | SQL query (HTML-encode `<>&"`) | `"SELECT ..."` |
+
+KB types: `metric`, `dimension`, `table`, `rule`. Names are UPPER_SNAKE_CASE matching the KB exactly.
+Missing any attribute = broken entity. Missing wrapping entirely = invisible to the platform.
+
+**Label = visible title.** The `data-graphit-label` MUST match the card's visible heading exactly. Users see the label in @ mention dropdowns and entity panels - if it doesn't match the title on screen, they can't find their chart.
+
+---
+
+## Workflow
+
+1. **Ask the user** what dashboard they want. Don't start querying until you know what they need.
+2. **Explore KB** to understand available metrics, dimensions, tables, and tables.
+3. **Find a data source** (`graphit ds list`) - prefer cached data sources (~100ms) over live warehouse (~10s).
+4. **Query data** and embed results as inline JS variables.
+5. **Build HTML** - all CSS and JS must be inline. Write to a local `.html` file.
+6. **Save** with `graphit dashboard update-html <id> --file <path>`.
+7. Give the user the dashboard URL so they can open it.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `graphit kb list <type>` | List metrics, dimensions, tables, rules, domains, synonyms |
+| `graphit kb get <type> <name>` | Full entity details by name |
+| `graphit kb search <query>` | Search across all KB types |
+| `graphit kb explore metric <name>` | Metric -> tables -> dimensions graph |
+| `graphit ds list` | List cached data sources (use these for fast queries) |
+| `graphit query "<sql>" --ds <id>` | Query cached data source (~100ms) |
+| `graphit query "<sql>" --warehouse --connection <id>` | Query live Snowflake (~10s) |
+| `graphit dashboard create --name "..."` | Create dashboard (returns ID) |
+| `graphit dashboard get-html <id>` | Get current HTML content of a dashboard |
+| `graphit dashboard update-html <id> --file <path>` | Upload HTML to dashboard |
+| `graphit dashboard list` | List existing dashboards |
+| `graphit metadata schemas --connection <id>` | List Snowflake schemas |
+| `graphit connector list` | List active connections |
+
+## Presenting Results to the User
+
+The user CANNOT see raw CLI output clearly. You MUST format and present every result - never silently consume tool output and move on.
+
+**After every query**, show the data:
+```
+Queried **MARKETING_UA** (ds_abc123, 6 rows):
+
+| Channel     | Spend    | Installs | CPI   |
+|-------------|----------|----------|-------|
+| Facebook    | $42,100  | 12,400   | $3.40 |
+| Google UAC  | $38,500  | 9,800    | $3.93 |
+| TikTok      | $21,300  | 8,200    | $2.60 |
+```
+```
+
+**After KB exploration**, summarize what you found:
+```
+Found **12 metrics** and **8 dimensions** on table MARKETING_UA:
+- **Metrics:** TOTAL_SPEND, CPI, ROAS_D7, ROAS_D30, INSTALLS, ...
+- **Dimensions:** MEDIA_SOURCE, CAMPAIGN_NAME, COUNTRY, PLATFORM, ...
+- **Rules:** EXCLUDE_ORGANIC (filters organic installs from paid metrics)
+```
+
+**Formatting rules:**
+- **Bold** metric names, table names, and key numbers
+- Use **markdown tables** for any tabular data (query results, entity lists, comparisons)
+- Format numbers: commas for thousands (`12,400`), `$` for currency, `%` for rates
+- After KB or data source discovery, list what's available before asking what to build
+- Show the SQL you ran (in a code block) so the user can validate the logic
+- When a query returns nulls or zero rows, explain what you checked and what went wrong
+- Narrate your progress between steps: "Found 3 data sources. Using **Marketing UA DS** (ds_abc123) which covers spend, installs, and ROAS columns."
+
+**Never do these:**
+- Run 3 queries silently then jump to building HTML
+- Say "I found the data" without showing what the data looks like
+- Present raw JSON output without formatting
+- Skip showing KB exploration results before proposing a dashboard
+
+---
+
+## Chart Type Quick Reference
+
+| Data shape | Chart | Inline technique |
+|---|---|---|
+| 1 temporal + 1 numeric | Line | SVG path |
+| 1 categorical + 1 numeric | Bar | CSS width% divs |
+| Single number | KPI card | Styled div |
+| Part-whole (max 5) | Donut | Canvas arc |
+| Matrix / cohort | Heatmap | CSS grid + opacity |
+| Stages | Funnel | CSS width% bars, narrowing |
+| Time sparkline | Sparkline | Inline SVG path |
+| Detail / raw data | Table | HTML table + hover rows |
+
+For more chart types (scatter, stacked bar, gauge, multi-series) see `references/chart-selection.md`.
+For inline implementations of each, see `references/graphit-style.md` (Chart Patterns section).
+
+---
+
+## Reference Files
+
+Detailed knowledge lives in `references/`. Consult the relevant file when you need depth beyond the quick references above.
+
+| File | Consult when |
+|------|-------------|
+| `dashboard-planning.md` | Building a multi-chart dashboard. Covers framing the question, picking archetype, mandatory rules, metric contracts, anti-patterns. |
+| `chart-selection.md` | Choosing chart types. Full dimension/measure defaults, perception ranking, cardinality guards, hard caps. |
+| `kb-exploration.md` | Starting a build. KB-first discovery, metric vs dimension, naming conventions, reuse patterns, formula syntax. |
+| `sql-reference.md` | Writing queries. DuckDB/Snowflake translation, formatting standards, gap-filling, JSON access, data source routing. |
+| `domain-lenses.md` | Data matches a business domain. Marketing, finance, product/growth, ops, sales - signals, key metrics, must-have charts, anti-patterns. |
+| `graphit-style.md` | Building the HTML. Design principles, typography scale, color system with usage rules, layout patterns (page structure, KPI cards, data tables). |
+| `chart-patterns.md` | Implementing charts. Inline CSS/SVG/canvas code for: horizontal bar, vertical bar, stacked bar, line/area, multi-series line, sparkline, donut, heatmap grid, funnel, gauge. |