@agentskillkit/agent-skills 1.0.1 → 3.2.1

package/packages/cli/lib/ui/common.js

@@ -0,0 +1,83 @@
+/**
+ * Common UI helpers for Clack-based CLI
+ */
+import * as p from "@clack/prompts";
+import { loadKnowledge } from "../recall.js";
+import { VERSION } from "../config.js";
+
+// ============================================================================
+// CLACK SYMBOLS (no emoji for consistency)
+// ============================================================================
+
+export const ICONS = {
+    brain: "◆",
+    learn: "◆",
+    recall: "◇",
+    stats: "▣",
+    success: "✓",
+    error: "✖",
+    warning: "⚠",
+    info: "●"
+};
+
+// ============================================================================
+// SHARED FUNCTIONS
+// ============================================================================
+
+/**
+ * Show app header
+ */
+export function showHeader() {
+    p.intro(`${ICONS.brain} Agent Skill Kit v${VERSION}`);
+}
+
+/**
+ * Show outro message
+ * @param {string} message 
+ */
+export function showSuccess(message) {
+    p.outro(`${ICONS.success} ${message}`);
+}
+
+/**
+ * Show error and exit
+ * @param {string} message 
+ */
+export function showError(message) {
+    p.cancel(`${ICONS.error} ${message}`);
+    process.exit(1);
+}
+
+/**
+ * Handle user cancellation (CTRL+C)
+ * @param {any} value 
+ */
+export function handleCancel(value) {
+    if (p.isCancel(value)) {
+        p.cancel("Operation cancelled.");
+        process.exit(0);
+    }
+}
+
+/**
+ * Get knowledge base with error handling
+ * @returns {object}
+ */
+export function getKnowledge() {
+    try {
+        return loadKnowledge();
+    } catch (e) {
+        showError("Failed to load knowledge base");
+        return { lessons: [] };
+    }
+}
+
+/**
+ * Format horizontal line
+ * @param {number} width 
+ */
+export function line(width = 50) {
+    return "─".repeat(width);
+}
+
+export { p, VERSION };

package/packages/cli/lib/ui/completion-ui.js

@@ -0,0 +1,126 @@
+/**
+ * Completion UI - Shell completion setup
+ */
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import fs from "fs";
+import path from "path";
+import os from "os";
+import {
+    getCompletionScript,
+    detectShell,
+    generatePowerShellCompletion,
+    generateBashCompletion,
+    generateZshCompletion
+} from "../completion.js";
+
+/**
+ * Interactive completion setup
+ */
+export async function runCompletionUI() {
+    p.intro("Shell Completion (Press ESC to exit)");
+
+    const action = await p.select({
+        message: "What would you like to do?",
+        options: [
+            { value: "install", label: "Install", hint: "Add shell completions" },
+            { value: "uninstall", label: "Uninstall", hint: "Remove completions" },
+            { value: "back", label: "← Back", hint: "Return to main menu" }
+        ]
+    });
+
+    if (p.isCancel(action) || action === "back") {
+        return;
+    }
+
+    const shell = await p.select({
+        message: "Select shell:",
+        options: [
+            { value: "powershell", label: "PowerShell", hint: "Windows default" },
+            { value: "bash", label: "Bash", hint: "Linux/macOS" },
+            { value: "zsh", label: "Zsh", hint: "macOS default" }
+        ],
+        initialValue: detectedShell
+    });
+
+    if (p.isCancel(shell)) return;
+
+    const { script } = getCompletionScript(shell);
+
+    if (action === "show") {
+        console.log("\n" + pc.dim("─".repeat(50)));
+        console.log(script);
+        console.log(pc.dim("─".repeat(50)) + "\n");
+
+        p.note(
+            `Copy the script above and add to your shell profile:\n` +
+            `• PowerShell: $PROFILE\n` +
+            `• Bash: ~/.bashrc\n` +
+            `• Zsh: ~/.zshrc`,
+            "Instructions"
+        );
+        return;
+    }
+
+    if (action === "install") {
+        const confirm = await p.confirm({
+            message: `Install completion for ${shell}?`
+        });
+
+        if (!confirm) return;
+
+        try {
+            let profilePath;
+
+            switch (shell) {
+                case "powershell": {
+                    // Get PowerShell profile path
+                    const psProfile = process.env.USERPROFILE
+                        ? path.join(process.env.USERPROFILE, "Documents", "PowerShell", "Microsoft.PowerShell_profile.ps1")
+                        : path.join(os.homedir(), "Documents", "PowerShell", "Microsoft.PowerShell_profile.ps1");
+
+                    profilePath = psProfile;
+                    break;
+                }
+                case "bash":
+                    profilePath = path.join(os.homedir(), ".bashrc");
+                    break;
+                case "zsh":
+                    profilePath = path.join(os.homedir(), ".zshrc");
+                    break;
+            }
+
+            // Ensure directory exists
+            fs.mkdirSync(path.dirname(profilePath), { recursive: true });
+
+            // Check if already installed
+            const existing = fs.existsSync(profilePath)
+                ? fs.readFileSync(profilePath, "utf8")
+                : "";
+
+            if (existing.includes("Agent Skill Kit")) {
+                p.note("Completion already installed!", pc.yellow("Skipped"));
+                return;
+            }
+
+            // Append to profile
+            fs.appendFileSync(profilePath, "\n" + script);
+
+            p.note(
+                `Completion installed to:\n${pc.cyan(profilePath)}\n\n` +
+                `Restart your terminal or run:\n` +
+                (shell === "powershell" ? `. $PROFILE` : `source ${profilePath}`),
+                pc.green("Installed")
+            );
+
+        } catch (e) {
+            p.note(
+                `Could not install automatically.\nError: ${e.message}\n\n` +
+                `Please manually add the script to your shell profile.`,
+                pc.red("Error")
+            );
+        }
+    }
+}
+
+export default runCompletionUI;

package/packages/cli/lib/ui/custom-select.js

@@ -0,0 +1,69 @@
+/**
+ * Custom Select Component - Using @clack/prompts native select
+ * This fixes the Windows terminal rendering issues with @clack/core
+ */
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+
+// ============================================================================
+// CUSTOM ICONS
+// ============================================================================
+
+const ITEM_ICONS = {
+    routing: "◆",
+    learn: "◆",
+    recall: "◇",
+    stats: "▣",
+    settings: "◇",
+    backup: "◇",
+    export: "◇",
+    proposals: "◇",
+    completion: "◇",
+    init: "◇",
+    exit: "×"
+};
+
+const ITEM_COLORS = {
+    routing: pc.cyan,
+    learn: pc.green,
+    recall: pc.blue,
+    stats: pc.yellow,
+    settings: pc.cyan,
+    backup: pc.gray,
+    export: pc.gray,
+    proposals: pc.yellow,
+    completion: pc.gray,
+    init: pc.green,
+    exit: pc.red
+};
+
+// ============================================================================
+// CUSTOM SELECT - Using native @clack/prompts
+// ============================================================================
+
+/**
+ * Custom select with icons - uses native clack select to fix Windows rendering
+ * @param {object} config 
+ * @returns {Promise<string|symbol>}
+ */
+export async function customSelect(config) {
+    const { message, items } = config;
+
+    // Transform items to clack format - clean labels without icons
+    const options = items.map((item) => ({
+        value: item.value,
+        label: item.label,
+        hint: item.hint
+    }));
+
+    const result = await p.select({
+        message,
+        options,
+        initialValue: items[0]?.value
+    });
+
+    return result;
+}
+
+export { ITEM_ICONS, ITEM_COLORS, pc };
+export { isCancel } from "@clack/prompts";

package/packages/cli/lib/ui/evolution-signals-ui.js

@@ -0,0 +1,107 @@
+/**
+ * Evolution Signals UI - View and manage pending evolution signals
+ */
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import { signalQueue, getEvolutionStats, reviewGate } from "../evolution-signal.js";
+import { loadKnowledge } from "../recall.js";
+import { loadSettings } from "../settings.js";
+
+/**
+ * Show pending evolution signals
+ */
+export async function runEvolutionSignalsUI() {
+    p.intro("📡 Evolution Signals");
+
+    const pending = signalQueue.getPending();
+    const stats = getEvolutionStats();
+
+    // Show summary
+    p.note(
+        `Pending: ${pc.yellow(stats.pending)}\n` +
+        `Approved: ${pc.green(stats.approved)}\n` +
+        `Rejected: ${pc.red(stats.rejected)}\n` +
+        `Executed: ${pc.cyan(stats.executed)}`,
+        "📊 Signal Queue Status"
+    );
+
+    if (pending.length === 0) {
+        p.note(pc.dim("No pending evolution signals"), "✅ All Clear");
+        return;
+    }
+
+    // Load lessons for context
+    const db = loadKnowledge();
+    const settings = loadSettings();
+
+    // Display pending signals with details
+    const signalChoices = pending.map(signal => {
+        const lesson = db.lessons.find(l => l.id === signal.lessonId);
+        const lessonName = lesson ? lesson.id : signal.lessonId;
+        const gate = reviewGate(signal, {
+            autoUpdating: settings.autoUpdating,
+            confidenceThreshold: 0.8
+        });
+
+        return {
+            value: signal.id,
+            label: `${pc.yellow('●')} ${lessonName}`,
+            hint: `${signal.reason} · confidence: ${(signal.confidence * 100).toFixed(0)}% ${gate.shouldAuto ? pc.green('(auto-eligible)') : pc.dim('(review)')}`
+        };
+    });
+
+    const action = await p.select({
+        message: "Pending Evolution Signals",
+        options: [
+            ...signalChoices,
+            { value: "back", label: "← Back" }
+        ]
+    });
+
+    if (p.isCancel(action) || action === "back") {
+        return;
+    }
+
+    // Show signal details
+    const signal = pending.find(s => s.id === action);
+    if (!signal) return;
+
+    const lesson = db.lessons.find(l => l.id === signal.lessonId);
+
+    p.note(
+        `${pc.bold('Lesson:')} ${signal.lessonId}\n` +
+        `${pc.bold('Reason:')} ${signal.reason}\n` +
+        `${pc.bold('Confidence:')} ${(signal.confidence * 100).toFixed(0)}%\n` +
+        `${pc.bold('Created:')} ${new Date(signal.createdAt).toLocaleString()}\n\n` +
+        `${pc.bold('Current Stats:')}\n` +
+        `  Hit Count: ${lesson?.hitCount || 0}\n` +
+        `  Maturity: ${lesson?.cognitive?.maturity || 'unknown'}\n` +
+        `  Intent: ${lesson?.intent || 'unknown'}\n\n` +
+        `${pc.bold('Metadata:')}\n` +
+        `  Trigger: ${signal.metadata.triggerEvent}\n` +
+        `  File: ${signal.metadata.file || 'N/A'}`,
+        "🔍 Signal Details"
+    );
+
+    // Action options
+    const signalAction = await p.select({
+        message: "What would you like to do?",
+        options: [
+            { value: "approve", label: "✅ Approve", hint: "Mark for evolution" },
+            { value: "reject", label: "❌ Reject", hint: "Dismiss this signal" },
+            { value: "back", label: "← Back" }
+        ]
+    });
+
+    if (p.isCancel(signalAction) || signalAction === "back") {
+        return;
+    }
+
+    if (signalAction === "approve") {
+        signalQueue.approve(signal.id);
+        p.note(pc.green(`✅ Signal approved for [${signal.lessonId}]`));
+    } else if (signalAction === "reject") {
+        signalQueue.reject(signal.id);
+        p.note(pc.red(`❌ Signal rejected for [${signal.lessonId}]`));
+    }
+}

package/packages/cli/lib/ui/export-ui.js

@@ -0,0 +1,94 @@
+/**
+ * Export/Import UI - Share settings between projects
+ */
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import path from "path";
+import { cwd } from "../config.js";
+import { exportData, importData } from "../export.js";
+
+/**
+ * Interactive export/import menu
+ */
+export async function runExportUI() {
+    p.intro("Export & Import (Press ESC to exit)");
+
+    while (true) {
+
+        const action = await p.select({
+            message: "What would you like to do?",
+            options: [
+                { value: "export", label: "Export", hint: "Export lessons to file" },
+                { value: "import", label: "Import", hint: "Import lessons from file" },
+                { value: "back", label: "← Back", hint: "Return to main menu" }
+            ]
+        });
+
+        if (p.isCancel(action) || action === "back") {
+            return;
+        }
+
+        switch (action) {
+            case "export": {
+                const filename = await p.text({
+                    message: "Export filename:",
+                    placeholder: "agent-skills-export.json",
+                    initialValue: "agent-skills-export.json"
+                });
+
+                if (p.isCancel(filename)) break;
+
+                const outputPath = path.join(cwd, filename);
+                const success = exportData(outputPath);
+
+                if (success) {
+                    p.note(
+                        `Exported to:\n${pc.dim(outputPath)}`,
+                        pc.green("Success")
+                    );
+                } else {
+                    p.note("Failed to export", pc.red("Error"));
+                }
+                break;
+            }
+
+            case "import": {
+                const filename = await p.text({
+                    message: "Import filename:",
+                    placeholder: "agent-skills-export.json",
+                    validate: (v) => {
+                        if (!v) return "Filename required";
+                    }
+                });
+
+                if (p.isCancel(filename)) break;
+
+                const mode = await p.select({
+                    message: "Import mode:",
+                    options: [
+                        { value: "merge", label: "Merge", hint: "Add new, keep existing" },
+                        { value: "replace", label: "Replace", hint: "Overwrite all data" }
+                    ]
+                });
+
+                if (p.isCancel(mode)) break;
+
+                const inputPath = path.join(cwd, filename);
+                const result = importData(inputPath, mode);
+
+                if (result.success) {
+                    p.note(
+                        `Imported ${result.lessonsCount} lesson(s)\n` +
+                        `Settings: ${result.hasSettings ? "Yes" : "No"}`,
+                        pc.green("Success")
+                    );
+                } else {
+                    p.note("Failed to import. Check file exists and is valid JSON.", pc.red("Error"));
+                }
+                break;
+            }
+        }
+    }
+}
+
+export default runExportUI;

package/packages/cli/lib/ui/fix-all-ui.js

@@ -0,0 +1,191 @@
+/**
+ * Fix All UI - Agent Coding Handoff (Smart Version)
+ * Instead of brittle regex auto-fix, generates AI-friendly prompts
+ */
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import path from "path";
+import fs from "fs";
+import { execSync } from "child_process";
+import { showIntro, createSpinner, showSuccessNote, showErrorNote, theme } from "./clack-helpers.js";
+import { loadMostRecentScan, loadScanResult } from "../recall.js";
+
+/**
+ * Fix All UI - Generate Agent handoff prompts
+ */
+export async function runFixAllUI(scanId = null) {
+    showIntro('🔧 Fix All - Agent Handoff');
+
+    // 1. Get scan results
+    let scanResult;
+    const spinner = createSpinner('Loading scan results...');
+
+    if (!scanId) {
+        scanResult = loadMostRecentScan();
+    } else {
+        scanResult = loadScanResult(scanId);
+    }
+
+    spinner.stop();
+
+    if (!scanResult) {
+        showErrorNote(
+            'No scan results found.\\n\\n' +
+            'Run "Scan All" first to generate scan data.',
+            '✗ No Scan Results'
+        );
+        return;
+    }
+
+    // 2. Show summary
+    console.log(`\\n${theme.primary(scanResult.totalIssues)} violations found\\n`);
+
+    // 3. Offer handoff options
+    const choice = await p.select({
+        message: "How would you like to fix these violations?",
+        options: [
+            { value: "agent", label: "🤖 Hand off to Agent", hint: "Generate AI fix request" },
+            { value: "skip", label: "← Skip", hint: "Return to menu" }
+        ]
+    });
+
+    if (p.isCancel(choice) || choice === "skip") {
+        p.cancel('Cancelled');
+        return;
+    }
+
+    // 4. Generate fix prompt
+    const fixPrompt = generateAgentFixPrompt(scanResult);
+
+    // 5. Ask where to send
+    const outputChoice = await p.select({
+        message: "Where to send the fix request?",
+        options: [
+            { value: "clipboard", label: "📋 Copy to Clipboard", hint: "Paste into AI chat" },
+            { value: "file", label: "💾 Save to File", hint: ".agent/fix-request.md" },
+            { value: "both", label: "✨ Both", hint: "Copy and save" }
+        ]
+    });
+
+    if (p.isCancel(outputChoice)) {
+        p.cancel('Cancelled');
+        return;
+    }
+
+    // 6. Execute handoff
+    let copied = false;
+    let saved = false;
+
+    if (outputChoice === "clipboard" || outputChoice === "both") {
+        copied = copyToClipboard(fixPrompt);
+    }
+
+    if (outputChoice === "file" || outputChoice === "both") {
+        saved = saveFixRequest(fixPrompt);
+    }
+
+    // 7. Show success
+    let message = '';
+    if (copied && saved) {
+        message = '✓ Copied to clipboard\\n✓ Saved to .agent/fix-request.md\\n\\nPaste into your AI coding assistant!';
+    } else if (copied) {
+        message = '✓ Copied to clipboard\\n\\nPaste into your AI coding assistant!';
+    } else if (saved) {
+        message = '✓ Saved to .agent/fix-request.md\\n\\nOpen file and copy into your AI coding assistant!';
+    } else {
+        message = 'Failed to copy or save. Check console for errors.';
+    }
+
+    p.note(message, '🎉 Fix Request Ready');
+}
+
+/**
+ * Generate AI-friendly fix prompt from scan results
+ */
+function generateAgentFixPrompt(scanResult) {
+    // Group by file
+    const byFile = {};
+    scanResult.issues.forEach(issue => {
+        const file = path.relative(process.cwd(), issue.file);
+        if (!byFile[file]) byFile[file] = [];
+        byFile[file].push(issue);
+    });
+
+    const fileList = Object.entries(byFile).sort((a, b) => b[1].length - a[1].length);
+
+    let prompt = '# Code Violation Fix Request\\n\\n## Summary\\n';
+    prompt += `- **Total violations**: ${scanResult.totalIssues}\\n`;
+    prompt += `- **Files affected**: ${fileList.length}\\n`;
+    prompt += `- **Errors**: ${scanResult.summary.errors}\\n`;
+    prompt += `- **Warnings**: ${scanResult.summary.warnings}\\n\\n`;
+    prompt += '## Violations by File\\n\\n';
+
+    fileList.forEach(([file, issues]) => {
+        prompt += `### 📁 \`${file}\`\\n\\n`;
+        issues.forEach(issue => {
+            const icon = issue.severity === 'ERROR' ? '🔴' : '⚠️';
+            prompt += `${icon} **Line ${issue.line}** - ${issue.severity}\\n`;
+            prompt += `- **Issue**: ${issue.message}\\n`;
+            if (issue.pattern) {
+                prompt += `- **Pattern**: \`${issue.pattern}\`\\n`;
+            }
+            prompt += '\\n';
+        });
+        prompt += '\\n';
+    });
+
+    prompt += '## Instructions\\n\\n';
+    prompt += 'Please fix all violations following these guidelines:\\n\\n';
+    prompt += '1. **Understand Context**: Read the entire file before making changes\\n';
+    prompt += '2. **Fix Correctly**: Address the root cause, not just the symptom\\n';
+    prompt += '3. **Maintain Style**: Keep existing code style and formatting\\n';
+    prompt += '4. **Test Changes**: Ensure no functionality is broken\\n';
+    prompt += '5. **Verify**: Check that all violations are resolved\\n\\n';
+    prompt += '**Important**: Some violations may be false positives. Use your judgment and skip if the code is actually correct.\\n\\n';
+    prompt += 'Ready to proceed with fixing these violations?\\n';
+
+    return prompt;
+}
+
+/**
+ * Copy text to clipboard (cross-platform)
+ */
+function copyToClipboard(text) {
+    try {
+        if (process.platform === 'win32') {
+            execSync('clip', { input: text });
+            return true;
+        } else if (process.platform === 'darwin') {
+            execSync('pbcopy', { input: text });
+            return true;
+        } else {
+            execSync('xclip -selection clipboard', { input: text });
+            return true;
+        }
+    } catch (e) {
+        console.error(`Clipboard error: ${e.message}`);
+        return false;
+    }
+}
+
+/**
+ * Save fix request to file
+ */
+function saveFixRequest(text) {
+    try {
+        const fixRequestPath = path.join('.agent', 'fix-request.md');
+        const dir = path.dirname(fixRequestPath);
+
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+
+        fs.writeFileSync(fixRequestPath, text, 'utf8');
+        return true;
+    } catch (e) {
+        console.error(`Save error: ${e.message}`);
+        return false;
+    }
+}
+
+export default runFixAllUI;

package/packages/cli/lib/ui/help-ui.js

@@ -0,0 +1,26 @@
+/**
+ * Help/Guide UI - Ultra Compact
+ */
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+
+export async function runHelpUI() {
+  process.stdout.write('\x1Bc');
+  p.intro(pc.cyan("📖 Quick Guide"));
+
+  const guide = [
+    `${pc.bold(" Lessons")}   View/edit learned patterns`,
+    `${pc.bold("💡 Insights")}  Stats & top violations`,
+    `${pc.bold("⚙️  Settings")} Auto-learn, threshold`,
+    `${pc.bold("💾 Backup")}    Export/import data`,
+    ``,
+    `${pc.dim("Agent Coding → learns mistakes → warns you")}`
+  ].join('\n');
+
+  p.note(guide, "Menu");
+
+  await p.select({
+    message: "",
+    options: [{ value: "back", label: "← Back" }]
+  });
+}