potion-kit 0.0.1

package/dist/commands/chat.js

@@ -0,0 +1,213 @@
+/**
+ * Chat command: load config, build system prompt, send user message, print reply.
+ * Conversation is persisted in .potion-kit/chat-history.json (project-scoped) so
+ * you can chat over multiple runs and build the site iteratively.
+ * - With no args: interactive mode (readline loop; type "exit" or Ctrl+C to quit).
+ * - With a message: one-shot, then exit. Use `potion-kit clear` to start a new conversation.
+ * Exits with clear error if .env / API keys are missing.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { createInterface } from "node:readline";
+import { loadLlmConfig } from "../config/index.js";
+import { createChat } from "../ai/client.js";
+import { getFullSystemPrompt } from "../ai/system-prompt.js";
+import { readHistory, writeHistory } from "./chat-history.js";
+import { cli, buildProgressMessage } from "../cli/formatting.js";
+const DEFAULT_MESSAGE = "What can you help me build? I’d like to create a static site with Handlebars and the UIPotion components.";
+const EXIT_COMMANDS = ["exit", "quit", "q"];
+function formatChatError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (/not a chat model|v1\/chat\/completions|v1\/completions/i.test(msg)) {
+        return (msg +
+            "\n\nUse a chat model (e.g. gpt-5.2, gpt-4o), not a completion-only model. Set POTION_KIT_MODEL in .env or ~/.potion-kit/config.json.");
+    }
+    return msg;
+}
+function printConfigError() {
+    const cwd = process.cwd();
+    const envPath = join(cwd, ".env");
+    const examplePath = join(cwd, ".env.example");
+    console.error(cli.error("potion-kit: missing LLM configuration.\n"));
+    console.error(cli.error("Create a .env file in this directory (or set env vars) with:"));
+    console.error(cli.error("  POTION_KIT_PROVIDER=openai   # or anthropic"));
+    console.error(cli.error("  OPENAI_API_KEY=sk-...       # if provider is openai"));
+    console.error(cli.error("  ANTHROPIC_API_KEY=...       # if provider is anthropic\n"));
+    if (!existsSync(envPath)) {
+        console.error(cli.error(`No .env found in ${cwd}.`));
+        if (existsSync(examplePath)) {
+            console.error(cli.error("Copy .env.example to .env:  cp .env.example .env"));
+        }
+        else {
+            console.error(cli.error("Add a .env file with the variables above."));
+        }
+    }
+    else {
+        console.error(cli.error(`Found .env in ${cwd}; check POTION_KIT_PROVIDER and the matching API key.`));
+    }
+    console.error("");
+}
+function buildMessages(systemPrompt, history, userMessage) {
+    const conversation = [
+        ...history.map((m) => ({ role: m.role, content: m.content })),
+        { role: "user", content: userMessage },
+    ];
+    return [{ role: "system", content: systemPrompt }, ...conversation];
+}
+export async function runChat(messageParts) {
+    const config = loadLlmConfig();
+    if (!config) {
+        printConfigError();
+        process.exit(1);
+    }
+    const cwd = process.cwd();
+    const hasMessage = messageParts.length > 0;
+    const userMessage = hasMessage ? messageParts.join(" ").trim() : "";
+    if (hasMessage) {
+        await runOneShot(cwd, config, userMessage);
+        return;
+    }
+    await runInteractive(cwd, config);
+}
+const DEFAULT_PROGRESS_TEXT = "Thinking… (may take a minute when using tools)";
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴"];
+const SPIN_INTERVAL_MS = 80;
+const LINE_PAD = 80; // width to clear when redrawing
+function createProgressReporter() {
+    let intervalId = null;
+    let currentMessage = DEFAULT_PROGRESS_TEXT;
+    let frameIndex = 0;
+    function tick() {
+        const frame = SPINNER_FRAMES[frameIndex % SPINNER_FRAMES.length];
+        const line = cli.spinner(frame) + " " + cli.progress(currentMessage);
+        const pad = " ".repeat(Math.max(0, LINE_PAD - (frame.length + 1 + currentMessage.length)));
+        process.stdout.write("\r" + line + pad + "\r");
+        frameIndex += 1;
+    }
+    const HIDE_CURSOR = "\x1b[?25l";
+    const SHOW_CURSOR = "\x1b[?25h";
+    return {
+        start: () => {
+            currentMessage = DEFAULT_PROGRESS_TEXT;
+            frameIndex = 0;
+            process.stdout.write(HIDE_CURSOR);
+            intervalId = setInterval(tick, SPIN_INTERVAL_MS);
+        },
+        onProgress: (msg) => {
+            currentMessage = msg;
+        },
+        progressMessageBuilder: (step, max, toolNames) => buildProgressMessage(step, max, toolNames),
+        clear: () => {
+            if (intervalId !== null) {
+                clearInterval(intervalId);
+                intervalId = null;
+            }
+            process.stdout.write("\r\x1b[2K\r" + SHOW_CURSOR);
+        },
+    };
+}
+async function runOneShot(cwd, config, userMessage) {
+    const systemPrompt = await getFullSystemPrompt();
+    const progress = createProgressReporter();
+    const chat = createChat(config, {
+        onProgress: progress.onProgress,
+        progressMessageBuilder: progress.progressMessageBuilder,
+        onError: (msg) => console.error(cli.error(msg)),
+    });
+    const history = readHistory(cwd);
+    const message = userMessage || DEFAULT_MESSAGE;
+    const messages = buildMessages(systemPrompt, history, message);
+    try {
+        console.log(cli.user("You: ") + message);
+        progress.start();
+        try {
+            const reply = await chat.send(messages);
+            progress.clear();
+            const replyToSave = reply.trim() || "(No text reply from the model.)";
+            writeHistory(cwd, [
+                ...history,
+                { role: "user", content: message },
+                { role: "assistant", content: replyToSave },
+            ]);
+            if (reply.trim()) {
+                console.log("\n" + cli.separator());
+                console.log(cli.agentLabel("Potion-kit:") + "\n");
+                console.log(cli.agentReply(reply));
+            }
+            else {
+                console.log(cli.intro("The model didn't return any text this time (it may have only run tools). Try rephrasing your request."));
+            }
+        }
+        finally {
+            progress.clear();
+        }
+    }
+    catch (err) {
+        console.error(cli.error("potion-kit: chat failed: " + formatChatError(err)));
+        process.exit(1);
+    }
+}
+async function runInteractive(cwd, config) {
+    const systemPrompt = await getFullSystemPrompt();
+    const progress = createProgressReporter();
+    const chat = createChat(config, {
+        onProgress: progress.onProgress,
+        progressMessageBuilder: progress.progressMessageBuilder,
+        onError: (msg) => console.error(cli.error(msg)),
+    });
+    let history = readHistory(cwd);
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    function saveAndExit() {
+        writeHistory(cwd, history);
+        rl.close();
+        process.exit(0);
+    }
+    process.on("SIGINT", () => {
+        rl.close();
+        writeHistory(cwd, history);
+        process.exit(0);
+    });
+    console.log(cli.intro('Chat with the AI to build your site. Type "exit" or Ctrl+C to quit.\n'));
+    function prompt() {
+        rl.question(cli.user("You: "), async (line) => {
+            const input = line.trim();
+            if (!input || EXIT_COMMANDS.includes(input.toLowerCase())) {
+                saveAndExit();
+                return;
+            }
+            try {
+                const messages = buildMessages(systemPrompt, history, input);
+                progress.start();
+                try {
+                    const reply = await chat.send(messages);
+                    progress.clear();
+                    const replyToSave = reply.trim() || "(No text reply from the model.)";
+                    history = [
+                        ...history,
+                        { role: "user", content: input },
+                        { role: "assistant", content: replyToSave },
+                    ];
+                    writeHistory(cwd, history);
+                    if (reply.trim()) {
+                        console.log("\n" + cli.separator());
+                        console.log(cli.agentLabel("Potion-kit:") + "\n");
+                        console.log(cli.agentReply(reply) + "\n");
+                    }
+                    else {
+                        console.log("\n" +
+                            cli.intro('The model didn\'t return any text this time (it may have only run tools). Try asking again or rephrase, e.g. "What were we building?" or "Summarize our plan."') +
+                            "\n");
+                    }
+                }
+                finally {
+                    progress.clear();
+                }
+            }
+            catch (err) {
+                console.error(cli.error("potion-kit: chat failed: " + formatChatError(err)));
+            }
+            prompt();
+        });
+    }
+    prompt();
+}

package/dist/commands/clear.js

@@ -0,0 +1,10 @@
+/**
+ * Clear command: delete chat history for the current project so the next
+ * chat run starts a new conversation.
+ */
+import { clearHistory } from "./chat-history.js";
+export async function runClear() {
+    const cwd = process.cwd();
+    clearHistory(cwd);
+    console.log("Chat history cleared for this project. The next chat will start a new conversation.");
+}

package/dist/config/index.js

@@ -0,0 +1 @@
+export { loadLlmConfig, CONFIG_DIR, CONFIG_FILE } from "./load.js";

package/dist/config/load.js

@@ -0,0 +1,65 @@
+import { readFileSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { config as loadEnv } from "dotenv";
+// Load .env from cwd (directory where the user ran potion-kit — works with global install).
+// Does not override existing process.env, so exported vars (e.g. OPENAI_API_KEY) take precedence.
+let envLoaded = false;
+function ensureEnvLoaded() {
+    if (envLoaded)
+        return;
+    envLoaded = true;
+    loadEnv(); // dotenv default: path is process.cwd() + '/.env'
+}
+const CONFIG_DIR = join(homedir(), ".potion-kit");
+const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+const PROVIDER_ENV = {
+    openai: "OPENAI_API_KEY",
+    anthropic: "ANTHROPIC_API_KEY",
+};
+const DEFAULT_MODELS = {
+    openai: "gpt-5.2",
+    anthropic: "claude-sonnet-4-5",
+};
+/**
+ * Load LLM config from:
+ * 1. .env in current working directory (if present)
+ * 2. Env vars: POTION_KIT_PROVIDER, POTION_KIT_MODEL, OPENAI_API_KEY / ANTHROPIC_API_KEY
+ * 3. Optional file: ~/.potion-kit/config.json (provider, model only; never put keys there).
+ *    See config.example.json in this package.
+ */
+export function loadLlmConfig() {
+    ensureEnvLoaded();
+    const provider = (process.env.POTION_KIT_PROVIDER ?? readConfigFile().provider);
+    const model = process.env.POTION_KIT_MODEL ?? readConfigFile().model;
+    if (!provider || !["openai", "anthropic"].includes(provider)) {
+        return null;
+    }
+    const apiKey = process.env[PROVIDER_ENV[provider]] ?? process.env.POTION_KIT_API_KEY;
+    if (!apiKey || typeof apiKey !== "string") {
+        return null;
+    }
+    return {
+        provider,
+        model: model ?? DEFAULT_MODELS[provider],
+        apiKey,
+        baseUrl: process.env.POTION_KIT_BASE_URL || undefined,
+    };
+}
+function readConfigFile() {
+    if (!existsSync(CONFIG_FILE)) {
+        return {};
+    }
+    try {
+        const raw = readFileSync(CONFIG_FILE, "utf-8");
+        const data = JSON.parse(raw);
+        return {
+            provider: data.provider,
+            model: data.model,
+        };
+    }
+    catch {
+        return {};
+    }
+}
+export { CONFIG_DIR, CONFIG_FILE };

package/dist/config/types.js

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+import { runChat } from "./commands/chat.js";
+import { runClear } from "./commands/clear.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// Built output is dist/index.js → package.json is one level up
+const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+const program = new Command();
+program
+    .name("potion-kit")
+    .description("CLI to build static sites with Handlebars, Markdown, and SCSS")
+    .version(pkg.version ?? "0.0.0");
+program
+    .command("chat [message...]", { isDefault: true })
+    .description("Chat with the AI (default command). Conversation is kept in .potion-kit/ so you can build the site over multiple turns.")
+    .action(async (messageParts) => {
+    await runChat(messageParts ?? []);
+});
+program
+    .command("clear")
+    .description("Clear chat history for this project (next chat starts a new conversation)")
+    .action(async () => {
+    await runClear();
+});
+program.parse();

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "potion-kit",
+  "version": "0.0.1",
+  "description": "CLI to build HaroldJS + UIPotion websites",
+  "author": "Julian Ćwirko <julian.io>",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "potion-kit": "dist/index.js"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "prepare": "node .husky/install.mjs",
+    "prepublishOnly": "npm run build",
+    "test": "node --import tsx --test test/*.test.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/ test/",
+    "lint:fix": "eslint src/ test/ --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
+    "pre-commit": "lint-staged && npm run typecheck"
+  },
+  "keywords": [
+    "harold",
+    "uipotion",
+    "static-site",
+    "cli",
+    "ui components"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/uiPotion/potion-kit.git"
+  },
+  "homepage": "https://github.com/uiPotion/potion-kit#readme",
+  "bugs": {
+    "url": "https://github.com/uiPotion/potion-kit/issues"
+  },
+  "files": [
+    "dist",
+    ".env.example",
+    "config.example.json",
+    ".husky/install.mjs"
+  ],
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "^1.0.0",
+    "@ai-sdk/openai": "^1.0.0",
+    "ai": "^4.0.0",
+    "chalk": "^5.6.2",
+    "commander": "^12.0.0",
+    "dotenv": "^16.4.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^20.0.0",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
+    "husky": "^9.0.0",
+    "lint-staged": "^16.0.0",
+    "prettier": "^3.8.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.0.0",
+    "typescript-eslint": "^8.54.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}