mewkit 1.0.0

package/dist/commands/validate.js

@@ -0,0 +1,139 @@
+import fs from "node:fs";
+import path from "node:path";
+import pc from "picocolors";
+/** Find MeowKit .claude/ in cwd only (no walk-up). */
+function findMeowkitDir(startDir) {
+    const candidate = path.join(startDir, ".claude");
+    if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
+        return candidate;
+    }
+    return null;
+}
+function checkFileExists(meowkitDir, relativePath) {
+    const fullPath = path.join(meowkitDir, relativePath);
+    const exists = fs.existsSync(fullPath);
+    return {
+        name: `File exists: ${relativePath}`,
+        passed: exists,
+        detail: exists ? fullPath : `Missing: ${fullPath}`,
+    };
+}
+function checkDirExists(meowkitDir, relativePath) {
+    const fullPath = path.join(meowkitDir, relativePath);
+    const exists = fs.existsSync(fullPath) && fs.statSync(fullPath).isDirectory();
+    return {
+        name: `Directory exists: ${relativePath}`,
+        passed: exists,
+        detail: exists ? fullPath : `Missing: ${fullPath}`,
+    };
+}
+function checkHooksExecutable(meowkitDir) {
+    const hooksDir = path.join(meowkitDir, "hooks");
+    const results = [];
+    if (!fs.existsSync(hooksDir)) {
+        results.push({
+            name: "Hooks directory",
+            passed: false,
+            detail: `Missing: ${hooksDir}`,
+        });
+        return results;
+    }
+    const hookFiles = fs.readdirSync(hooksDir).filter((f) => !f.startsWith("."));
+    if (hookFiles.length === 0) {
+        results.push({
+            name: "Hooks present",
+            passed: false,
+            detail: "No hook files found in hooks/",
+        });
+        return results;
+    }
+    for (const hook of hookFiles) {
+        const hookPath = path.join(hooksDir, hook);
+        try {
+            fs.accessSync(hookPath, fs.constants.X_OK);
+            results.push({
+                name: `Hook executable: ${hook}`,
+                passed: true,
+                detail: hookPath,
+            });
+        }
+        catch {
+            results.push({
+                name: `Hook executable: ${hook}`,
+                passed: false,
+                detail: `Not executable: ${hookPath}`,
+            });
+        }
+    }
+    return results;
+}
+function checkConfigJson(meowkitDir) {
+    const configPath = path.join(meowkitDir, "meowkit.config.json");
+    if (!fs.existsSync(configPath)) {
+        return {
+            name: "Config JSON valid",
+            passed: false,
+            detail: `Missing: ${configPath}`,
+        };
+    }
+    try {
+        const content = fs.readFileSync(configPath, "utf-8");
+        JSON.parse(content);
+        return {
+            name: "Config JSON valid",
+            passed: true,
+            detail: configPath,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            name: "Config JSON valid",
+            passed: false,
+            detail: `Invalid JSON: ${message}`,
+        };
+    }
+}
+function printResult(result) {
+    const icon = result.passed ? pc.green("PASS") : pc.red("FAIL");
+    console.log(`  [${icon}] ${result.name}`);
+    if (!result.passed) {
+        console.log(`         ${pc.dim(result.detail)}`);
+    }
+}
+export async function validate() {
+    console.log(pc.bold(pc.cyan("Validating .claude/ project structure...")));
+    console.log();
+    const meowkitDir = findMeowkitDir(process.cwd());
+    if (!meowkitDir) {
+        console.error(pc.red("Could not find .claude/ directory in current or parent directories."));
+        process.exit(1);
+    }
+    console.log(`${pc.dim("Found:")} ${meowkitDir}`);
+    console.log();
+    const results = [];
+    // Required directories
+    results.push(checkDirExists(meowkitDir, "agents"));
+    results.push(checkDirExists(meowkitDir, "hooks"));
+    // CLAUDE.md lives at project root (Claude Code reads it from there)
+    const projectRoot = path.dirname(meowkitDir);
+    results.push(checkFileExists(projectRoot, "CLAUDE.md"));
+    // Hooks executable
+    results.push(...checkHooksExecutable(meowkitDir));
+    // Config JSON
+    results.push(checkConfigJson(meowkitDir));
+    for (const result of results) {
+        printResult(result);
+    }
+    console.log();
+    const passCount = results.filter((r) => r.passed).length;
+    const failCount = results.filter((r) => !r.passed).length;
+    if (failCount === 0) {
+        console.log(pc.green(pc.bold(`All ${passCount} checks passed.`)));
+    }
+    else {
+        console.log(`${pc.green(`${passCount} passed`)}, ${pc.red(`${failCount} failed`)}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import minimist from "minimist";
+import pc from "picocolors";
+import { upgrade } from "./commands/upgrade.js";
+import { validate } from "./commands/validate.js";
+import { budget } from "./commands/budget.js";
+import { memory } from "./commands/memory.js";
+import { doctor } from "./commands/doctor.js";
+import { setup } from "./commands/setup.js";
+import { task } from "./commands/task.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkgJson = JSON.parse(fs.readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+const VERSION = pkgJson.version;
+function printHelp() {
+    console.log(`
+${pc.bold(pc.cyan("meowkit"))} ${pc.dim(`v${VERSION}`)} — MeowKit runtime CLI
+
+${pc.bold("Usage:")}
+  meowkit <command> [options]
+
+${pc.bold("Commands:")}
+  ${pc.green("upgrade")}    Upgrade create-meowkit to the latest version
+  ${pc.green("validate")}   Validate .claude/ project structure
+  ${pc.green("budget")}     View token usage and cost log
+  ${pc.green("memory")}     Manage agent memory (lessons & patterns)
+  ${pc.green("setup")}      Guided post-scaffold configuration
+  ${pc.green("doctor")}     Diagnose common environment issues
+  ${pc.green("status")}     Print version and config summary
+  ${pc.green("task")}       Create and list task files (new, list)
+
+${pc.bold("Options:")}
+  --help, -h       Show help
+  --version, -v    Show version
+`);
+}
+async function printStatus() {
+    const channel = VERSION.includes("-beta") || VERSION.includes("-rc") ? "beta" : "stable";
+    console.log(`${pc.bold(pc.cyan("meowkit"))} ${pc.dim(`v${VERSION}`)} ${pc.dim(`(${channel})`)}`);
+    console.log();
+    const configPath = ".claude/meowkit.config.json";
+    try {
+        const content = fs.readFileSync(configPath, "utf-8");
+        const config = JSON.parse(content);
+        console.log(`${pc.bold("Config:")} ${configPath}`);
+        for (const [key, value] of Object.entries(config)) {
+            console.log(`  ${pc.dim(key)}: ${String(value)}`);
+        }
+    }
+    catch {
+        console.log(`${pc.dim("No .claude/meowkit.config.json found.")}`);
+    }
+}
+async function main() {
+    const args = minimist(process.argv.slice(2), {
+        boolean: ["help", "version", "check", "beta", "list", "monthly", "clear", "show", "stats", "report", "all"],
+        string: ["only", "type", "priority", "status"],
+        alias: { h: "help", v: "version" },
+    });
+    if (args.version) {
+        console.log(VERSION);
+        return;
+    }
+    const command = args._[0];
+    if (args.help && !command) {
+        printHelp();
+        return;
+    }
+    switch (command) {
+        case "upgrade":
+            await upgrade({ check: args.check, beta: args.beta, list: args.list });
+            break;
+        case "validate":
+            await validate();
+            break;
+        case "budget":
+            await budget({ monthly: args.monthly });
+            break;
+        case "memory":
+            await memory({ clear: args.clear, show: args.show, stats: args.stats });
+            break;
+        case "setup":
+            setup({ only: args.only });
+            break;
+        case "doctor":
+            await doctor({ report: args.report });
+            break;
+        case "status":
+            await printStatus();
+            break;
+        case "task": {
+            const subcommand = args._[1];
+            // positional description: everything after the subcommand that isn't a flag
+            const description = args._.slice(2).join(" ");
+            task({
+                subcommand,
+                type: args.type,
+                priority: args.priority,
+                all: args.all,
+                status: args.status,
+                description: description || undefined,
+            });
+            break;
+        }
+        default:
+            if (command) {
+                console.error(pc.red(`Unknown command: ${command}`));
+                console.log();
+            }
+            printHelp();
+            break;
+    }
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(pc.red(`Fatal: ${message}`));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,26 @@
+/** Output modes controlled by --json and --verbose flags */
+interface LoggerOptions {
+    json: boolean;
+    verbose: boolean;
+}
+/** Initialize logger with CLI flags. Call once at startup. */
+export declare function initLogger(opts: Partial<LoggerOptions> & {
+    command?: string;
+}): void;
+/** Info message (always shown in text mode, accumulated in json mode) */
+export declare function info(msg: string): void;
+/** Success message with green checkmark */
+export declare function success(msg: string): void;
+/** Warning message */
+export declare function warn(msg: string): void;
+/** Error message. Sets json output success=false. */
+export declare function error(msg: string): void;
+/** Debug message (only in --verbose mode) */
+export declare function debug(msg: string): void;
+/** Set structured data for json output */
+export declare function setData(key: string, value: unknown): void;
+/** Flush json output at end of command. No-op in text mode. */
+export declare function flush(): void;
+/** Check if json mode is active */
+export declare function isJson(): boolean;
+export {};

package/dist/logger.js

@@ -0,0 +1,70 @@
+import pc from "picocolors";
+let options = { json: false, verbose: false };
+let jsonOutput = { success: true, command: "", data: {}, messages: [] };
+/** Initialize logger with CLI flags. Call once at startup. */
+export function initLogger(opts) {
+    options = { json: opts.json ?? false, verbose: opts.verbose ?? false };
+    jsonOutput = { success: true, command: opts.command ?? "", data: {}, messages: [] };
+}
+/** Info message (always shown in text mode, accumulated in json mode) */
+export function info(msg) {
+    if (options.json) {
+        jsonOutput.messages.push({ level: "info", text: msg });
+    }
+    else {
+        console.log(msg);
+    }
+}
+/** Success message with green checkmark */
+export function success(msg) {
+    if (options.json) {
+        jsonOutput.messages.push({ level: "success", text: msg });
+    }
+    else {
+        console.log(`${pc.green("✓")} ${msg}`);
+    }
+}
+/** Warning message */
+export function warn(msg) {
+    if (options.json) {
+        jsonOutput.messages.push({ level: "warn", text: msg });
+    }
+    else {
+        console.warn(pc.yellow(`⚠ ${msg}`));
+    }
+}
+/** Error message. Sets json output success=false. */
+export function error(msg) {
+    jsonOutput.success = false;
+    if (options.json) {
+        jsonOutput.messages.push({ level: "error", text: msg });
+    }
+    else {
+        console.error(pc.red(`✗ ${msg}`));
+    }
+}
+/** Debug message (only in --verbose mode) */
+export function debug(msg) {
+    if (options.json) {
+        if (options.verbose)
+            jsonOutput.messages.push({ level: "debug", text: msg });
+    }
+    else if (options.verbose) {
+        console.log(pc.dim(`[debug] ${msg}`));
+    }
+}
+/** Set structured data for json output */
+export function setData(key, value) {
+    jsonOutput.data[key] = value;
+}
+/** Flush json output at end of command. No-op in text mode. */
+export function flush() {
+    if (options.json) {
+        console.log(JSON.stringify(jsonOutput, null, 2));
+    }
+}
+/** Check if json mode is active */
+export function isJson() {
+    return options.json;
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "mewkit",
+  "version": "1.0.0",
+  "description": "MeowKit runtime CLI — upgrade, validate, budget, memory, doctor",
+  "type": "module",
+  "bin": {
+    "meowkit": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "picocolors": "^1.1.0",
+    "minimist": "^1.2.8"
+  },
+  "devDependencies": {
+    "@types/minimist": "^1.2.5",
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT"
+}