@knowledgine/cli 0.2.0 → 0.3.0

package/dist/commands/setup-rules.js

@@ -0,0 +1,309 @@
+import { join } from "path";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync } from "fs";
+import * as p from "@clack/prompts";
+import { colors, symbols } from "../lib/ui/index.js";
+import { getClaudeCodeRuleTemplate, getCursorRuleTemplate, getWindsurfRuleTemplate, getClineRuleTemplate, getCodexRuleTemplate, getGithubCopilotRuleTemplate, getGeminiRuleTemplate, getContinueRuleTemplate, getZedRuleTemplate, getOpencodeRuleTemplate, getAntigravityRuleTemplate, } from "../templates/rules/index.js";
+const MARKER_START = "<!-- knowledgine:rules:start -->";
+const MARKER_END = "<!-- knowledgine:rules:end -->";
+export const RULE_TARGETS = [
+    {
+        value: "claude-code",
+        label: "Claude Code",
+        description: "Anthropic's CLI agent",
+        supported: true,
+        getRulePath: (root) => join(root, "CLAUDE.md"),
+        strategy: "append-section",
+        getTemplate: getClaudeCodeRuleTemplate,
+    },
+    {
+        value: "codex",
+        label: "Codex CLI",
+        description: "OpenAI's coding agent",
+        supported: true,
+        getRulePath: (root) => join(root, "AGENTS.md"),
+        strategy: "append-section",
+        getTemplate: getCodexRuleTemplate,
+        sharedFile: "agents-md",
+    },
+    {
+        value: "cursor",
+        label: "Cursor",
+        description: "AI-first code editor",
+        supported: true,
+        getRulePath: (root) => join(root, ".cursor", "rules", "knowledgine.mdc"),
+        strategy: "create-file",
+        getTemplate: getCursorRuleTemplate,
+    },
+    {
+        value: "windsurf",
+        label: "Windsurf",
+        description: "Codeium's AI IDE",
+        supported: true,
+        getRulePath: (root) => join(root, ".windsurf", "rules", "knowledgine.md"),
+        strategy: "create-file",
+        getTemplate: getWindsurfRuleTemplate,
+    },
+    {
+        value: "cline",
+        label: "Cline",
+        description: "Cline VS Code extension",
+        supported: true,
+        getRulePath: (root) => join(root, ".clinerules", "knowledgine.md"),
+        strategy: "create-file",
+        getTemplate: getClineRuleTemplate,
+    },
+    {
+        value: "github-copilot",
+        label: "GitHub Copilot CLI",
+        description: "AI pair programmer CLI",
+        supported: true,
+        getRulePath: (root) => join(root, ".github", "copilot-instructions.md"),
+        strategy: "create-file",
+        getTemplate: getGithubCopilotRuleTemplate,
+        sharedFile: "copilot-instructions",
+    },
+    {
+        value: "vscode",
+        label: "VS Code",
+        description: "GitHub Copilot MCP",
+        supported: true,
+        getRulePath: (root) => join(root, ".github", "copilot-instructions.md"),
+        strategy: "create-file",
+        getTemplate: getGithubCopilotRuleTemplate,
+        sharedFile: "copilot-instructions",
+    },
+    {
+        value: "gemini",
+        label: "Gemini CLI",
+        description: "Google's AI coding agent",
+        supported: true,
+        getRulePath: (root) => join(root, "GEMINI.md"),
+        strategy: "append-section",
+        getTemplate: getGeminiRuleTemplate,
+        sharedFile: "gemini-md",
+    },
+    {
+        value: "continue",
+        label: "Continue",
+        description: "Continue.dev MCP configuration",
+        supported: true,
+        getRulePath: (root) => join(root, ".continuerules"),
+        strategy: "append-section",
+        getTemplate: getContinueRuleTemplate,
+    },
+    {
+        value: "zed",
+        label: "Zed",
+        description: "High-performance editor",
+        supported: true,
+        getRulePath: (root) => join(root, ".rules"),
+        strategy: "create-file",
+        getTemplate: getZedRuleTemplate,
+    },
+    {
+        value: "opencode",
+        label: "OpenCode",
+        description: "opencode.ai MCP configuration",
+        supported: true,
+        getRulePath: (root) => join(root, "AGENTS.md"),
+        strategy: "append-section",
+        getTemplate: getOpencodeRuleTemplate,
+        sharedFile: "agents-md",
+    },
+    {
+        value: "antigravity",
+        label: "Antigravity",
+        description: "Google's AI development platform",
+        supported: true,
+        getRulePath: (root) => join(root, "AGENTS.md"),
+        strategy: "append-section",
+        getTemplate: getAntigravityRuleTemplate,
+        sharedFile: "agents-md",
+    },
+    {
+        value: "claude-desktop",
+        label: "Claude Desktop",
+        description: "Anthropic's desktop app",
+        supported: false,
+        getRulePath: (_root) => "",
+        strategy: "create-file",
+        getTemplate: (_root) => "",
+    },
+];
+export function writeRuleFile(target, projectRoot, options) {
+    const filePath = target.getRulePath(projectRoot);
+    const templateContent = target.getTemplate(projectRoot);
+    if (target.strategy === "append-section") {
+        let finalContent;
+        if (existsSync(filePath)) {
+            const existing = readFileSync(filePath, "utf-8");
+            const startIdx = existing.indexOf(MARKER_START);
+            const endIdx = existing.indexOf(MARKER_END);
+            if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+                // Replace between markers (inclusive)
+                finalContent =
+                    existing.slice(0, startIdx) +
+                        templateContent +
+                        existing.slice(endIdx + MARKER_END.length);
+            }
+            else {
+                // Append to end
+                const trimmed = existing.trimEnd();
+                finalContent = trimmed ? trimmed + "\n\n" + templateContent + "\n" : templateContent + "\n";
+            }
+            if (!options.dryRun) {
+                copyFileSync(filePath, filePath + ".bak");
+                writeFileSync(filePath, finalContent, "utf-8");
+            }
+        }
+        else {
+            finalContent = templateContent + "\n";
+            if (!options.dryRun) {
+                const dir = join(filePath, "..");
+                if (!existsSync(dir)) {
+                    mkdirSync(dir, { recursive: true });
+                }
+                writeFileSync(filePath, finalContent, "utf-8");
+            }
+        }
+        return { target: target.label, status: "ok", filePath };
+    }
+    // create-file strategy
+    if (existsSync(filePath) && !options.force) {
+        return {
+            target: target.label,
+            status: "skipped",
+            filePath,
+            note: "File already exists. Use --force to overwrite.",
+        };
+    }
+    if (!options.dryRun) {
+        const dir = join(filePath, "..");
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        if (existsSync(filePath)) {
+            copyFileSync(filePath, filePath + ".bak");
+        }
+        writeFileSync(filePath, templateContent, "utf-8");
+    }
+    return { target: target.label, status: "ok", filePath };
+}
+export async function interactiveRulesSetup(projectRoot, preselectedMcpTargets) {
+    const shouldAdd = await p.confirm({
+        message: "Add knowledgine rules to your AI tools?",
+    });
+    if (p.isCancel(shouldAdd) || !shouldAdd) {
+        return [];
+    }
+    const preselected = new Set(preselectedMcpTargets ?? []);
+    const selected = await p.multiselect({
+        message: "Which AI tools should have knowledgine rules? (space to select, enter to confirm)",
+        options: RULE_TARGETS.map((t) => ({
+            value: t.value,
+            label: t.label,
+            hint: t.supported ? t.description : `${t.description} (MCP only - no rule file support)`,
+            // Note: @clack/prompts multiselect doesn't support disabled items,
+            // so unsupported targets are shown with a hint but remain selectable.
+            // We filter them out after selection.
+        })),
+        initialValues: RULE_TARGETS.filter((t) => t.supported && preselected.has(t.value)).map((t) => t.value),
+    });
+    if (p.isCancel(selected)) {
+        return [];
+    }
+    const selectedValues = selected;
+    const results = [];
+    const writtenSharedFiles = new Set();
+    const s = p.spinner();
+    for (const value of selectedValues) {
+        const ruleTarget = RULE_TARGETS.find((t) => t.value === value);
+        if (!ruleTarget)
+            continue;
+        if (!ruleTarget.supported) {
+            results.push({
+                target: ruleTarget?.label ?? value,
+                status: "skipped",
+                filePath: "",
+                note: "MCP only - no rule file support",
+            });
+            continue;
+        }
+        // Dedup shared files
+        if (ruleTarget.sharedFile) {
+            if (writtenSharedFiles.has(ruleTarget.sharedFile)) {
+                results.push({
+                    target: ruleTarget?.label ?? value,
+                    status: "skipped",
+                    filePath: ruleTarget.getRulePath(projectRoot),
+                    note: `Shared file already written for ${ruleTarget.sharedFile}`,
+                });
+                continue;
+            }
+            writtenSharedFiles.add(ruleTarget.sharedFile);
+        }
+        s.start(`Writing rules for ${ruleTarget.label}...`);
+        try {
+            const result = writeRuleFile(ruleTarget, projectRoot, {});
+            if (result.status === "ok") {
+                s.stop(`${symbols.success} ${colors.success(ruleTarget.label)} rules written`);
+            }
+            else {
+                s.stop(`${symbols.arrow} ${colors.dim(ruleTarget.label)} skipped${result.note ? ` — ${result.note}` : ""}`);
+            }
+            results.push(result);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            s.stop(`${symbols.error} ${colors.error(ruleTarget.label)} failed`);
+            results.push({
+                target: ruleTarget?.label ?? value,
+                status: "fail",
+                filePath: ruleTarget.getRulePath(projectRoot),
+                error: msg,
+            });
+        }
+    }
+    return results;
+}
+export function nonInteractiveRulesSetup(target, projectRoot, options) {
+    const ruleTarget = RULE_TARGETS.find((t) => t.value === target);
+    if (!ruleTarget) {
+        console.error(`${symbols.error} Unknown target: ${target}. Supported: ${RULE_TARGETS.filter((t) => t.supported)
+            .map((t) => t.value)
+            .join(", ")}`);
+        process.exitCode = 1;
+        return;
+    }
+    if (!ruleTarget.supported) {
+        console.error(`${symbols.error} ${ruleTarget.label} does not support rule files (MCP only).`);
+        process.exitCode = 1;
+        return;
+    }
+    const templateContent = ruleTarget.getTemplate(projectRoot);
+    const filePath = ruleTarget.getRulePath(projectRoot);
+    if (!options.write) {
+        console.error(`\nRule file preview for ${ruleTarget.label}:`);
+        console.error(colors.dim(`Path: ${filePath}`));
+        console.error("");
+        console.error(templateContent);
+        console.error("");
+        console.error(`${symbols.arrow} ${colors.dim(`To write: kg setup rules --target ${target} --write`)}`);
+        return;
+    }
+    try {
+        const result = writeRuleFile(ruleTarget, projectRoot, {});
+        if (result.status === "ok") {
+            console.error(`${symbols.success} ${colors.success(`Rules written: ${filePath}`)}`);
+        }
+        else if (result.status === "skipped") {
+            console.error(`${symbols.arrow} ${colors.dim(`Skipped: ${filePath}`)}${result.note ? ` — ${result.note}` : ""}`);
+        }
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        console.error(`${symbols.error} Failed to write rules: ${msg}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=setup-rules.js.map

package/dist/commands/setup-rules.js.map

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

package/dist/commands/setup-skills.d.ts

@@ -0,0 +1,55 @@
+import { type SkillName } from "../templates/skills/index.js";
+export interface SkillSetupTarget {
+    /** Matches TARGETS[].value in setup.ts */
+    value: string;
+    label: string;
+    description: string;
+    /** false = shown disabled in multiselect */
+    supported: boolean;
+    /** Returns the skill directory path for this agent given the project root */
+    getSkillDir: (root: string) => string;
+    /** Identifier for shared-dir dedup (agents sharing the same physical dir) */
+    sharedDir?: string;
+}
+export interface SkillWriteResult {
+    target: string;
+    status: "ok" | "skipped" | "fail";
+    skillDir: string;
+    skillCount: number;
+    error?: string;
+    note?: string;
+}
+export declare const SKILL_TARGETS: SkillSetupTarget[];
+/**
+ * Writes skill files (SKILL.md + references/) for a single target agent.
+ *
+ * When `dryRun` is true, the function computes what would be written and
+ * returns the result without touching the filesystem.
+ *
+ * When `force` is false (default) and the skill directory already exists,
+ * the write is skipped.
+ */
+export declare function writeSkills(target: SkillSetupTarget, projectRoot: string, skillNames: SkillName[], options: {
+    dryRun?: boolean;
+    force?: boolean;
+}): SkillWriteResult;
+/**
+ * Interactive wizard for the "Skills" step of `kg setup`.
+ *
+ * @param projectRoot - Absolute path to the project root.
+ * @param preselectedMcpTargets - Agent values already chosen in the MCP step,
+ *   used to pre-populate the multiselect.
+ */
+export declare function interactiveSkillsSetup(projectRoot: string, preselectedMcpTargets?: string[]): Promise<SkillWriteResult[]>;
+/**
+ * Non-interactive (scripted) variant used when `--target` is specified on the
+ * command line.
+ *
+ * @param target - Agent value string (e.g. "claude-code").
+ * @param projectRoot - Absolute path to the project root.
+ * @param options.write - When false (default) only prints a preview.
+ */
+export declare function nonInteractiveSkillsSetup(target: string, projectRoot: string, options: {
+    write?: boolean;
+}): void;
+//# sourceMappingURL=setup-skills.d.ts.map

package/dist/commands/setup-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-skills.d.ts","sourceRoot":"","sources":["../../src/commands/setup-skills.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAM7F,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,SAAS,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAYD,eAAO,MAAM,aAAa,EAAE,gBAAgB,EAgG3C,CAAC;AAMF;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7C,gBAAgB,CA2DlB;AAMD;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,qBAAqB,CAAC,EAAE,MAAM,EAAE,GAC/B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA4I7B;AAMD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,IAAI,CAsDN"}