johankit 0.0.2 → 0.0.3

package/README.md

@@ -8,11 +8,6 @@ Think of it as your personal **code snapshot toolkit**: lightweight, fast, and a
 
 ## Why JohanKit?
 
-The name combines:
-
-- **Johan** – a nod to the “creator” or developer archetype.
-- **Kit** – a set of practical tools.
-
 JohanKit is a “kit for developers,” crafted to streamline coding sessions, prototype features quickly, and integrate seamlessly with AI-assisted refactoring or review tools.
 
 ---

package/Readme.md

@@ -0,0 +1,56 @@
+# JohanKit CLI
+
+JohanKit é uma ferramenta para copiar, colar e sincronizar snapshots de código de forma inteligente usando AI.
+
+## Comandos
+
+### Copy
+Copia um diretório ou arquivos específicos para o clipboard em formato JSON.
+
+```bash
+johankit copy <dir> [exts]
+```
+
+- `<dir>`: Diretório a copiar (padrão `.`)
+- `[exts]`: Extensões separadas por vírgula (ex: `ts,js`)
+
+### Paste
+Aplica o conteúdo do clipboard em um diretório.
+
+```bash
+johankit paste <dir>
+```
+
+- `<dir>`: Diretório de destino (padrão `.`)
+
+### Prompt
+Gera um prompt com o snapshot atual do diretório para AI, copiando para o clipboard.
+
+```bash
+johankit prompt <dir> "<user request>"
+```
+
+### Sync
+Aplica patches gerados pela AI em um diretório e atualiza o clipboard com o novo snapshot.
+
+```bash
+johankit sync <dir>
+```
+
+## Exemplo de Uso
+
+```bash
+johankit prompt src "refatorar para async/await"
+johankit sync src
+```
+
+## Configuração
+Crie um arquivo `johankit.yaml` na raiz do projeto para customizar os diretórios e arquivos a ignorar.
+
+```yaml
+ignore:
+  - dist
+  - node_modules
+```
+
+Por padrão, os seguintes diretórios já são ignorados: `.git`, `node_modules`, `dist`, `build`, `coverage`, `tmp`, `temp`.

package/cli/commands/paste.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paste = void 0;
+const write_1 = require("../../core/write");
+const clipboard_1 = require("../../core/clipboard");
+const cleanCodeBlock_1 = __importDefault(require("../../utils/cleanCodeBlock"));
+async function paste(dir) {
+    try {
+        const content = await (0, clipboard_1.readClipboard)();
+        if (!content) {
+            throw new Error("Clipboard empty or inaccessible");
+        }
+        let files;
+        try {
+            const { lang, cleaned } = (0, cleanCodeBlock_1.default)(content);
+            files = JSON.parse(cleaned);
+        }
+        catch (e) {
+            throw new Error("Clipboard content is not valid JSON");
+        }
+        if (!Array.isArray(files)) {
+            throw new Error("Clipboard content is not a JSON array");
+        }
+        const isValidSnapshot = files.every(f => typeof f.path === 'string' && typeof f.content === 'string');
+        if (!isValidSnapshot) {
+            throw new Error("JSON does not match FileSnapshot structure {path, content}");
+        }
+        (0, write_1.writeFiles)(dir, files, true);
+        process.stdout.write("✔ Pasted from clipboard\n");
+    }
+    catch (error) {
+        process.stderr.write("✖ Paste failed\n");
+        if (error instanceof Error) {
+            process.stderr.write(`${error.message}\n`);
+        }
+        process.exit(1);
+    }
+}
+exports.paste = paste;

package/cli/commands/paste.ts

@@ -0,0 +1,42 @@
+import { writeFiles } from "../../core/write";
+import { readClipboard } from "../../core/clipboard";
+import cleanCodeBlock from "../../utils/cleanCodeBlock";
+
+export async function paste(dir: string) {
+    try {
+        const content = await readClipboard();
+
+        if (!content) {
+            throw new Error("Clipboard empty or inaccessible");
+        }
+
+        let files;
+        try {
+            const { lang, cleaned } = cleanCodeBlock(content);
+            files = JSON.parse(cleaned);
+        } catch (e) {
+            throw new Error("Clipboard content is not valid JSON");
+        }
+
+        if (!Array.isArray(files)) {
+            throw new Error("Clipboard content is not a JSON array");
+        }
+
+        const isValidSnapshot = files.every(f =>
+            typeof f.path === 'string' && typeof f.content === 'string'
+        );
+
+        if (!isValidSnapshot) {
+            throw new Error("JSON does not match FileSnapshot structure {path, content}");
+        }
+
+        writeFiles(dir, files, true);
+        process.stdout.write("✔ Pasted from clipboard\n");
+    } catch (error) {
+        process.stderr.write("✖ Paste failed\n");
+        if (error instanceof Error) {
+            process.stderr.write(`${error.message}\n`);
+        }
+        process.exit(1);
+    }
+}

package/cli/commands/prompt.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prompt = void 0;
+// src/cli/commands/prompt.ts
+const scan_1 = require("../../core/scan");
+const clipboard_1 = require("../../core/clipboard");
+const vm_1 = require("../../core/vm");
+async function prompt(dir, userPrompt) {
+    const snapshot = (0, scan_1.scanDir)(dir);
+    const template = `
+You are an AI software engineer.
+
+You will receive a JSON array representing a snapshot of a codebase.
+Each item has the following structure:
+
+{
+  "path": "relative/path/to/file.ext",
+  "content": "full file content"
+}
+
+---
+
+SNAPSHOT
+${JSON.stringify(snapshot, null, 2)}
+
+---
+
+YOUR TASK
+Propose changes according to the user request.
+
+Return ONLY a JSON array of patches.
+
+PATCH FORMAT (STRICT)
+{
+  "path": "relative/path/to/file.ext",
+  "content": "FULL updated file content (omit for delete)"
+}
+
+IMPORTANT RULES
+- Do NOT return explanations
+- Do NOT return markdown
+- Return ONLY valid JSON inside the \"\`\`\`\"
+- Always return within a Markdown Code Block (with \"\`\`\`json\" syntax highlighting)\")
+
+USER REQUEST
+${userPrompt}
+`;
+    try {
+        (0, vm_1.runInVm)(`module.exports = async function() { return ${JSON.stringify(template.trim())}; }`)();
+        await (0, clipboard_1.copyToClipboard)(template.trim());
+        process.stdout.write(template.trim());
+        process.stdout.write("\n\n✔ Prompt + Snapshot copied to clipboard\n");
+    }
+    catch (e) {
+        process.stdout.write(template.trim());
+        process.stderr.write("\n✖ Failed to execute in VM or copy to clipboard\n");
+    }
+}
+exports.prompt = prompt;

package/cli/commands/prompt.ts

@@ -0,0 +1,57 @@
+// src/cli/commands/prompt.ts
+import { scanDir } from "../../core/scan";
+import { copyToClipboard } from "../../core/clipboard";
+import { runInVm } from "../../core/vm";
+
+export async function prompt(dir: string, userPrompt: string) {
+  const snapshot = scanDir(dir);
+
+  const template = `
+You are an AI software engineer.
+
+You will receive a JSON array representing a snapshot of a codebase.
+Each item has the following structure:
+
+{
+  "path": "relative/path/to/file.ext",
+  "content": "full file content"
+}
+
+---
+
+SNAPSHOT
+${JSON.stringify(snapshot, null, 2)}
+
+---
+
+YOUR TASK
+Propose changes according to the user request.
+
+Return ONLY a JSON array of patches.
+
+PATCH FORMAT (STRICT)
+{
+  "path": "relative/path/to/file.ext",
+  "content": "FULL updated file content (omit for delete)"
+}
+
+IMPORTANT RULES
+- Do NOT return explanations
+- Do NOT return markdown
+- Return ONLY valid JSON inside the \"\`\`\`\"
+- Always return within a Markdown Code Block (with \"\`\`\`json\" syntax highlighting)\")
+
+USER REQUEST
+${userPrompt}
+`;
+
+  try {
+    runInVm(`module.exports = async function() { return ${JSON.stringify(template.trim())}; }`)();
+    await copyToClipboard(template.trim());
+    process.stdout.write(template.trim());
+    process.stdout.write("\n\n✔ Prompt + Snapshot copied to clipboard\n");
+  } catch (e) {
+    process.stdout.write(template.trim());
+    process.stderr.write("\n✖ Failed to execute in VM or copy to clipboard\n");
+  }
+}

package/cli/commands/sync.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sync = void 0;
+// src/cli/commands/sync.ts
+const scan_1 = require("../../core/scan");
+const diff_1 = require("../../core/diff");
+const clipboard_1 = require("../../core/clipboard");
+const validation_1 = require("../../core/validation");
+const vm_1 = require("../../core/vm");
+async function sync(dir) {
+    try {
+        const snapshotBefore = (0, scan_1.scanDir)(dir);
+        const template = `
+You are an AI software engineer.
+
+You will receive a JSON array representing a snapshot of a codebase.
+Each item has the following structure:
+
+\`\`\`json
+{
+  "path": "relative/path/to/file.ext",
+  "content": "full file content"
+}
+\`\`\`
+
+---
+
+SNAPSHOT
+${JSON.stringify(snapshotBefore, null, 2)}
+
+---
+
+YOUR TASK
+Propose changes according to the user request.
+
+Return ONLY a JSON array of patches.
+
+PATCH FORMAT (STRICT)
+{
+  \"path\": \"relative/path/to/file.ext\",
+  \"content\": \"FULL updated file content (omit for delete)\"
+}
+
+IMPORTANT RULES
+- Do NOT return explanations
+- Do NOT return markdown
+- Return ONLY valid JSON
+
+USER REQUEST
+<Replace this with the user request>
+`;
+        await (0, clipboard_1.copyToClipboard)(template.trim());
+        process.stdout.write("✔ Prompt with snapshot copied to clipboard\n");
+        const input = await readStdin();
+        let patches;
+        try {
+            patches = (0, vm_1.runInVm)(`module.exports = function() { return ${input}; }`)();
+        }
+        catch {
+            throw new Error("Invalid JSON input or execution in VM failed");
+        }
+        const validated = (0, validation_1.validatePatches)(patches);
+        (0, diff_1.applyDiff)(dir, validated);
+        const snapshotAfter = (0, scan_1.scanDir)(dir);
+        await (0, clipboard_1.copyToClipboard)(JSON.stringify(snapshotAfter, null, 2));
+        process.stdout.write("✔ Sync applied and new snapshot copied to clipboard\n");
+    }
+    catch (error) {
+        process.stderr.write("✖ Sync failed\n");
+        if (error instanceof Error) {
+            process.stderr.write(`${error.message}\n`);
+        }
+        process.exit(1);
+    }
+}
+exports.sync = sync;
+function readStdin() {
+    return new Promise(resolve => {
+        let data = "";
+        process.stdin.on("data", c => (data += c));
+        process.stdin.on("end", () => resolve(data));
+    });
+}

package/cli/commands/sync.ts

@@ -0,0 +1,87 @@
+// src/cli/commands/sync.ts
+import { scanDir } from "../../core/scan";
+import { applyDiff } from "../../core/diff";
+import { copyToClipboard } from "../../core/clipboard";
+import { validatePatches } from "../../core/validation";
+import { writeFiles } from "../../core/write";
+import { runInVm } from "../../core/vm";
+
+export async function sync(dir: string) {
+  try {
+    const snapshotBefore = scanDir(dir);
+
+    const template = `
+You are an AI software engineer.
+
+You will receive a JSON array representing a snapshot of a codebase.
+Each item has the following structure:
+
+\`\`\`json
+{
+  "path": "relative/path/to/file.ext",
+  "content": "full file content"
+}
+\`\`\`
+
+---
+
+SNAPSHOT
+${JSON.stringify(snapshotBefore, null, 2)}
+
+---
+
+YOUR TASK
+Propose changes according to the user request.
+
+Return ONLY a JSON array of patches.
+
+PATCH FORMAT (STRICT)
+{
+  \"path\": \"relative/path/to/file.ext\",
+  \"content\": \"FULL updated file content (omit for delete)\"
+}
+
+IMPORTANT RULES
+- Do NOT return explanations
+- Do NOT return markdown
+- Return ONLY valid JSON
+
+USER REQUEST
+<Replace this with the user request>
+`;
+
+    await copyToClipboard(template.trim());
+    process.stdout.write("✔ Prompt with snapshot copied to clipboard\n");
+
+    const input = await readStdin();
+
+    let patches;
+    try {
+      patches = runInVm(`module.exports = function() { return ${input}; }`)();
+    } catch {
+      throw new Error("Invalid JSON input or execution in VM failed");
+    }
+
+    const validated = validatePatches(patches);
+    applyDiff(dir, validated);
+
+    const snapshotAfter = scanDir(dir);
+    await copyToClipboard(JSON.stringify(snapshotAfter, null, 2));
+
+    process.stdout.write("✔ Sync applied and new snapshot copied to clipboard\n");
+  } catch (error) {
+    process.stderr.write("✖ Sync failed\n");
+    if (error instanceof Error) {
+      process.stderr.write(`${error.message}\n`);
+    }
+    process.exit(1);
+  }
+}
+
+function readStdin(): Promise<string> {
+  return new Promise(resolve => {
+    let data = "";
+    process.stdin.on("data", c => (data += c));
+    process.stdin.on("end", () => resolve(data));
+  });
+}

package/commands/paste.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paste = void 0;
+// src/cli/commands/paste.ts
+const write_1 = require("../../core/write");
+const clipboard_1 = require("../../core/clipboard");
+async function paste(dir) {
+    try {
+        const content = await (0, clipboard_1.readClipboard)();
+        if (!content) {
+            throw new Error("Clipboard empty or inaccessible");
+        }
+        let files;
+        try {
+            let cleanContent = content.replace(/^\uFEFF/, "").trim();
+            // Remove code block markers ``` ou ````` caso existam
+            cleanContent = cleanContent.replace(/```+\s*json?/g, "").replace(/```+/g, "");
+            files = JSON.parse(cleanContent);
+        }
+        catch (e) {
+            throw new Error("Clipboard content is not valid JSON");
+        }
+        if (!Array.isArray(files)) {
+            throw new Error("Clipboard content is not a JSON array");
+        }
+        // Validação simples do snapshot
+        const isValidSnapshot = files.every(f => typeof f.path === 'string' && typeof f.content === 'string');
+        if (!isValidSnapshot) {
+            throw new Error("JSON does not match FileSnapshot structure {path, content}");
+        }
+        (0, write_1.writeFiles)(dir, files, true);
+        process.stdout.write("✔ Pasted from clipboard\n");
+    }
+    catch (error) {
+        process.stderr.write("✖ Paste failed\n");
+        if (error instanceof Error) {
+            process.stderr.write(`${error.message}\n`);
+        }
+        process.exit(1);
+    }
+}
+exports.paste = paste;

package/commands/paste.ts

@@ -0,0 +1,45 @@
+// src/cli/commands/paste.ts
+import { writeFiles } from "../../core/write";
+import { readClipboard } from "../../core/clipboard";
+
+export async function paste(dir: string) {
+    try {
+        const content = await readClipboard();
+
+        if (!content) {
+            throw new Error("Clipboard empty or inaccessible");
+        }
+
+        let files;
+        try {
+            let cleanContent = content.replace(/^\uFEFF/, "").trim();
+            // Remove code block markers ``` ou ````` caso existam
+            cleanContent = cleanContent.replace(/```+\s*json?/g, "").replace(/```+/g, "");
+            files = JSON.parse(cleanContent);
+        } catch (e) {
+            throw new Error("Clipboard content is not valid JSON");
+        }
+
+        if (!Array.isArray(files)) {
+            throw new Error("Clipboard content is not a JSON array");
+        }
+
+        // Validação simples do snapshot
+        const isValidSnapshot = files.every(f =>
+            typeof f.path === 'string' && typeof f.content === 'string'
+        );
+
+        if (!isValidSnapshot) {
+            throw new Error("JSON does not match FileSnapshot structure {path, content}");
+        }
+
+        writeFiles(dir, files, true);
+        process.stdout.write("✔ Pasted from clipboard\n");
+    } catch (error) {
+        process.stderr.write("✖ Paste failed\n");
+        if (error instanceof Error) {
+            process.stderr.write(`${error.message}\n`);
+        }
+        process.exit(1);
+    }
+}

package/core/config.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = void 0;
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("fs");
+const js_yaml_1 = require("js-yaml");
+const CONFIG_FILENAME = "johankit.yaml";
+const DEFAULT_IGNORE = [
+    ".git",
+    "node_modules",
+    "dist",
+    "build",
+    "coverage",
+    "tmp",
+    "temp",
+];
+function loadConfig(basePath) {
+    const configPath = path_1.default.join(basePath, CONFIG_FILENAME);
+    try {
+        const content = (0, fs_1.readFileSync)(configPath, "utf8");
+        const loadedConfig = (0, js_yaml_1.load)(content);
+        return {
+            ignore: [
+                ...DEFAULT_IGNORE,
+                ...(loadedConfig.ignore || []),
+            ],
+        };
+    }
+    catch (error) {
+        if (error instanceof Error && error.code === "ENOENT") {
+            return {
+                ignore: DEFAULT_IGNORE,
+            };
+        }
+        console.warn(`[johankit] Aviso: Falha ao carregar ${CONFIG_FILENAME}. Usando defaults.`, error);
+        return {
+            ignore: DEFAULT_IGNORE,
+        };
+    }
+}
+exports.loadConfig = loadConfig;

package/core/config.ts

@@ -0,0 +1,42 @@
+import path from "path";
+import { readFileSync } from "fs";
+import { load } from "js-yaml";
+import { Config } from "../types";
+
+const CONFIG_FILENAME = "johankit.yaml";
+const DEFAULT_IGNORE = [
+  ".git",
+  "node_modules",
+  "dist",
+  "build",
+  "coverage",
+  "tmp",
+  "temp",
+];
+
+export function loadConfig(basePath: string): Config {
+  const configPath = path.join(basePath, CONFIG_FILENAME);
+
+  try {
+    const content = readFileSync(configPath, "utf8");
+    const loadedConfig = load(content) as Partial<Config>;
+
+    return {
+      ignore: [
+        ...DEFAULT_IGNORE,
+        ...(loadedConfig.ignore || []),
+      ],
+    };
+  } catch (error) {
+    if (error instanceof Error && (error as any).code === "ENOENT") {
+      return {
+        ignore: DEFAULT_IGNORE,
+      };
+    }
+
+    console.warn(`[johankit] Aviso: Falha ao carregar ${CONFIG_FILENAME}. Usando defaults.`, error);
+    return {
+      ignore: DEFAULT_IGNORE,
+    };
+  }
+}

package/core/schema.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePatches = void 0;
+function isValidPatch(patch) {
+    if (typeof patch !== "object" || patch === null)
+        return false;
+    if (typeof patch.path !== "string" || patch.path.length === 0)
+        return false;
+    const validTypes = ["modify", "create", "delete"];
+    if (!validTypes.includes(patch.type))
+        return false;
+    if (patch.type === "delete") {
+        return patch.content === undefined;
+    }
+    else {
+        return typeof patch.content === "string";
+    }
+}
+function validatePatches(patches) {
+    if (!Array.isArray(patches)) {
+        throw new Error("O patch deve ser um array JSON válido");
+    }
+    for (const [index, patch] of patches.entries()) {
+        if (!isValidPatch(patch)) {
+            throw new Error(`Patch inválido no índice ${index}: ${JSON.stringify(patch, null, 2)}.\nEsperado: { type: 'modify'|'create'|'delete', path: string, content?: string }`);
+        }
+    }
+    return patches;
+}
+exports.validatePatches = validatePatches;

package/core/schema.ts

@@ -0,0 +1,29 @@
+import { DiffPatch } from "./diff";
+
+function isValidPatch(patch: any): boolean {
+  if (typeof patch !== "object" || patch === null) return false;
+  if (typeof patch.path !== "string" || patch.path.length === 0) return false;
+
+  const validTypes = ["modify", "create", "delete"];
+  if (!validTypes.includes(patch.type)) return false;
+
+  if (patch.type === "delete") {
+    return patch.content === undefined;
+  } else {
+    return typeof patch.content === "string";
+  }
+}
+
+export function validatePatches(patches: any): DiffPatch[] {
+  if (!Array.isArray(patches)) {
+    throw new Error("O patch deve ser um array JSON válido");
+  }
+
+  for (const [index, patch] of patches.entries()) {
+    if (!isValidPatch(patch)) {
+      throw new Error(`Patch inválido no índice ${index}: ${JSON.stringify(patch, null, 2)}.\nEsperado: { type: 'modify'|'create'|'delete', path: string, content?: string }`);
+    }
+  }
+
+  return patches as DiffPatch[];
+}