bitcompass 0.3.3 → 0.3.5

package/dist/commands/commands.d.ts

@@ -0,0 +1,7 @@
+export declare const runCommandsSearch: (query?: string) => Promise<void>;
+export declare const runCommandsList: () => Promise<void>;
+export declare const runCommandsPull: (id?: string, options?: {
+    global?: boolean;
+    copy?: boolean;
+}) => Promise<void>;
+export declare const runCommandsPush: (file?: string) => Promise<void>;

package/dist/commands/commands.js

@@ -0,0 +1,120 @@
+import inquirer from 'inquirer';
+import ora from 'ora';
+import chalk from 'chalk';
+import { loadCredentials } from '../auth/config.js';
+import { searchRules, fetchRules, getRuleById, insertRule } from '../api/client.js';
+import { pullRuleToFile } from '../lib/rule-file-ops.js';
+export const runCommandsSearch = async (query) => {
+    if (!loadCredentials()) {
+        console.error(chalk.red('Not logged in. Run bitcompass login.'));
+        process.exit(1);
+    }
+    const q = query ?? (await inquirer.prompt([{ name: 'q', message: 'Search query', type: 'input' }])).q;
+    const spinner = ora('Searching commands…').start();
+    const list = await searchRules(q, { kind: 'command', limit: 20 });
+    spinner.stop();
+    if (list.length === 0) {
+        console.log(chalk.yellow('No commands found.'));
+        return;
+    }
+    const choice = await inquirer.prompt([
+        {
+            name: 'id',
+            message: 'Select a command',
+            type: 'list',
+            choices: list.map((r) => ({ name: `${r.title} (${r.id})`, value: r.id })),
+        },
+    ]);
+    const rule = await getRuleById(choice.id);
+    if (rule) {
+        console.log(chalk.cyan(rule.title));
+        console.log(rule.body);
+    }
+};
+export const runCommandsList = async () => {
+    if (!loadCredentials()) {
+        console.error(chalk.red('Not logged in. Run bitcompass login.'));
+        process.exit(1);
+    }
+    const spinner = ora('Loading commands…').start();
+    const list = await fetchRules('command');
+    spinner.stop();
+    list.forEach((r) => console.log(`${chalk.cyan(r.title)}  ${chalk.dim(r.id)}`));
+    if (list.length === 0)
+        console.log(chalk.yellow('No commands yet.'));
+};
+export const runCommandsPull = async (id, options) => {
+    if (!loadCredentials()) {
+        console.error(chalk.red('Not logged in. Run bitcompass login.'));
+        process.exit(1);
+    }
+    let targetId = id;
+    if (!targetId) {
+        const spinner = ora('Loading commands…').start();
+        const list = await fetchRules('command');
+        spinner.stop();
+        if (list.length === 0) {
+            console.log(chalk.yellow('No commands to pull.'));
+            return;
+        }
+        const choice = await inquirer.prompt([
+            { name: 'id', message: 'Select command', type: 'list', choices: list.map((r) => ({ name: r.title, value: r.id })) },
+        ]);
+        targetId = choice.id;
+    }
+    const spinner = ora('Pulling command…').start();
+    try {
+        const filename = await pullRuleToFile(targetId, {
+            global: options?.global,
+            useSymlink: !options?.copy, // Use symlink unless --copy flag is set
+        });
+        spinner.succeed(chalk.green('Pulled command'));
+        console.log(chalk.dim(filename));
+        if (options?.copy) {
+            console.log(chalk.dim('Copied as file (not a symlink)'));
+        }
+        else {
+            console.log(chalk.dim('Created symbolic link to cached command'));
+        }
+        if (options?.global) {
+            console.log(chalk.dim('Installed globally for all projects'));
+        }
+    }
+    catch (error) {
+        spinner.fail(chalk.red('Failed to pull command'));
+        console.error(chalk.red(error.message));
+        process.exit(1);
+    }
+};
+export const runCommandsPush = async (file) => {
+    if (!loadCredentials()) {
+        console.error(chalk.red('Not logged in. Run bitcompass login.'));
+        process.exit(1);
+    }
+    let payload;
+    if (file) {
+        const { readFileSync } = await import('fs');
+        const raw = readFileSync(file, 'utf-8');
+        try {
+            payload = JSON.parse(raw);
+            payload.kind = 'command';
+        }
+        catch {
+            const lines = raw.split('\n');
+            const title = lines[0].replace(/^#\s*/, '') || 'Untitled';
+            payload = { kind: 'command', title, description: '', body: raw };
+        }
+    }
+    else {
+        const answers = await inquirer.prompt([
+            { name: 'title', message: 'Command title', type: 'input', default: 'Untitled' },
+            { name: 'description', message: 'Description', type: 'input', default: '' },
+            { name: 'body', message: 'Command content', type: 'editor', default: '' },
+        ]);
+        payload = { kind: 'command', title: answers.title, description: answers.description, body: answers.body };
+    }
+    const spinner = ora('Publishing command…').start();
+    const created = await insertRule(payload);
+    spinner.succeed(chalk.green('Published command ') + created.id);
+    console.log(chalk.dim(created.title));
+};

package/dist/commands/rules.d.ts

@@ -2,5 +2,6 @@ export declare const runRulesSearch: (query?: string) => Promise<void>;
 export declare const runRulesList: () => Promise<void>;
 export declare const runRulesPull: (id?: string, options?: {
     global?: boolean;
+    copy?: boolean;
 }) => Promise<void>;
 export declare const runRulesPush: (file?: string) => Promise<void>;

package/dist/commands/rules.js

@@ -1,13 +1,9 @@
 import inquirer from 'inquirer';
 import ora from 'ora';
 import chalk from 'chalk';
-import { mkdirSync, writeFileSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
 import { loadCredentials } from '../auth/config.js';
-import { getProjectConfig } from '../auth/project-config.js';
 import { searchRules, fetchRules, getRuleById, insertRule } from '../api/client.js';
-import { ruleFilename } from '../lib/slug.js';
+import { pullRuleToFile } from '../lib/rule-file-ops.js';
 export const runRulesSearch = async (query) => {
     if (!loadCredentials()) {
         console.error(chalk.red('Not logged in. Run bitcompass login.'));
@@ -66,28 +62,28 @@ export const runRulesPull = async (id, options) => {
         ]);
         targetId = choice.id;
     }
-    const rule = await getRuleById(targetId);
-    if (!rule) {
-        console.error(chalk.red('Rule not found.'));
-        process.exit(1);
-    }
-    let outDir;
-    if (options?.global) {
-        // Use global location: ~/.cursor/rules/
-        outDir = join(homedir(), '.cursor', 'rules');
-    }
-    else {
-        // Use project config (default behavior)
-        const { outputPath } = getProjectConfig({ warnIfMissing: true });
-        outDir = join(process.cwd(), outputPath);
+    const spinner = ora('Pulling rule…').start();
+    try {
+        const filename = await pullRuleToFile(targetId, {
+            global: options?.global,
+            useSymlink: !options?.copy, // Use symlink unless --copy flag is set
+        });
+        spinner.succeed(chalk.green('Pulled rule'));
+        console.log(chalk.dim(filename));
+        if (options?.copy) {
+            console.log(chalk.dim('Copied as file (not a symlink)'));
+        }
+        else {
+            console.log(chalk.dim('Created symbolic link to cached rule'));
+        }
+        if (options?.global) {
+            console.log(chalk.dim('Installed globally for all projects'));
+        }
     }
-    mkdirSync(outDir, { recursive: true });
-    const filename = join(outDir, ruleFilename(rule.title, rule.id));
-    const content = `# ${rule.title}\n\n${rule.description}\n\n${rule.body}\n`;
-    writeFileSync(filename, content);
-    console.log(chalk.green('Wrote'), filename);
-    if (options?.global) {
-        console.log(chalk.dim('Installed globally for all projects'));
+    catch (error) {
+        spinner.fail(chalk.red('Failed to pull rule'));
+        console.error(chalk.red(error.message));
+        process.exit(1);
     }
 };
 export const runRulesPush = async (file) => {

package/dist/commands/skills.d.ts

@@ -0,0 +1,7 @@
+export declare const runSkillsSearch: (query?: string) => Promise<void>;
+export declare const runSkillsList: () => Promise<void>;
+export declare const runSkillsPull: (id?: string, options?: {
+    global?: boolean;
+    copy?: boolean;
+}) => Promise<void>;
+export declare const runSkillsPush: (file?: string) => Promise<void>;

package/dist/commands/skills.js

@@ -0,0 +1,120 @@
+import inquirer from 'inquirer';
+import ora from 'ora';
+import chalk from 'chalk';
+import { loadCredentials } from '../auth/config.js';
+import { searchRules, fetchRules, getRuleById, insertRule } from '../api/client.js';
+import { pullRuleToFile } from '../lib/rule-file-ops.js';
+export const runSkillsSearch = async (query) => {
+    if (!loadCredentials()) {
+        console.error(chalk.red('Not logged in. Run bitcompass login.'));
+        process.exit(1);
+    }
+    const q = query ?? (await inquirer.prompt([{ name: 'q', message: 'Search query', type: 'input' }])).q;
+    const spinner = ora('Searching skills…').start();
+    const list = await searchRules(q, { kind: 'skill', limit: 20 });
+    spinner.stop();
+    if (list.length === 0) {
+        console.log(chalk.yellow('No skills found.'));
+        return;
+    }
+    const choice = await inquirer.prompt([
+        {
+            name: 'id',
+            message: 'Select a skill',
+            type: 'list',
+            choices: list.map((r) => ({ name: `${r.title} (${r.id})`, value: r.id })),
+        },
+    ]);
+    const rule = await getRuleById(choice.id);
+    if (rule) {
+        console.log(chalk.cyan(rule.title));
+        console.log(rule.body);
+    }
+};
+export const runSkillsList = async () => {
+    if (!loadCredentials()) {
+        console.error(chalk.red('Not logged in. Run bitcompass login.'));
+        process.exit(1);
+    }
+    const spinner = ora('Loading skills…').start();
+    const list = await fetchRules('skill');
+    spinner.stop();
+    list.forEach((r) => console.log(`${chalk.cyan(r.title)}  ${chalk.dim(r.id)}`));
+    if (list.length === 0)
+        console.log(chalk.yellow('No skills yet.'));
+};
+export const runSkillsPull = async (id, options) => {
+    if (!loadCredentials()) {
+        console.error(chalk.red('Not logged in. Run bitcompass login.'));
+        process.exit(1);
+    }
+    let targetId = id;
+    if (!targetId) {
+        const spinner = ora('Loading skills…').start();
+        const list = await fetchRules('skill');
+        spinner.stop();
+        if (list.length === 0) {
+            console.log(chalk.yellow('No skills to pull.'));
+            return;
+        }
+        const choice = await inquirer.prompt([
+            { name: 'id', message: 'Select skill', type: 'list', choices: list.map((r) => ({ name: r.title, value: r.id })) },
+        ]);
+        targetId = choice.id;
+    }
+    const spinner = ora('Pulling skill…').start();
+    try {
+        const filename = await pullRuleToFile(targetId, {
+            global: options?.global,
+            useSymlink: !options?.copy, // Use symlink unless --copy flag is set
+        });
+        spinner.succeed(chalk.green('Pulled skill'));
+        console.log(chalk.dim(filename));
+        if (options?.copy) {
+            console.log(chalk.dim('Copied as file (not a symlink)'));
+        }
+        else {
+            console.log(chalk.dim('Created symbolic link to cached skill'));
+        }
+        if (options?.global) {
+            console.log(chalk.dim('Installed globally for all projects'));
+        }
+    }
+    catch (error) {
+        spinner.fail(chalk.red('Failed to pull skill'));
+        console.error(chalk.red(error.message));
+        process.exit(1);
+    }
+};
+export const runSkillsPush = async (file) => {
+    if (!loadCredentials()) {
+        console.error(chalk.red('Not logged in. Run bitcompass login.'));
+        process.exit(1);
+    }
+    let payload;
+    if (file) {
+        const { readFileSync } = await import('fs');
+        const raw = readFileSync(file, 'utf-8');
+        try {
+            payload = JSON.parse(raw);
+            payload.kind = 'skill';
+        }
+        catch {
+            const lines = raw.split('\n');
+            const title = lines[0].replace(/^#\s*/, '') || 'Untitled';
+            payload = { kind: 'skill', title, description: '', body: raw };
+        }
+    }
+    else {
+        const answers = await inquirer.prompt([
+            { name: 'title', message: 'Skill title', type: 'input', default: 'Untitled' },
+            { name: 'description', message: 'Description', type: 'input', default: '' },
+            { name: 'body', message: 'Skill content', type: 'editor', default: '' },
+        ]);
+        payload = { kind: 'skill', title: answers.title, description: answers.description, body: answers.body };
+    }
+    const spinner = ora('Publishing skill…').start();
+    const created = await insertRule(payload);
+    spinner.succeed(chalk.green('Published skill ') + created.id);
+    console.log(chalk.dim(created.title));
+};

package/dist/commands/solutions.d.ts

@@ -1,5 +1,6 @@
 export declare const runSolutionsSearch: (query?: string) => Promise<void>;
 export declare const runSolutionsPull: (id?: string, options?: {
     global?: boolean;
+    copy?: boolean;
 }) => Promise<void>;
 export declare const runSolutionsPush: (file?: string) => Promise<void>;

package/dist/commands/solutions.js

@@ -1,13 +1,9 @@
 import inquirer from 'inquirer';
 import ora from 'ora';
 import chalk from 'chalk';
-import { mkdirSync, writeFileSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
 import { loadCredentials } from '../auth/config.js';
-import { getProjectConfig } from '../auth/project-config.js';
 import { searchRules, fetchRules, getRuleById, insertRule } from '../api/client.js';
-import { solutionFilename } from '../lib/slug.js';
+import { pullRuleToFile } from '../lib/rule-file-ops.js';
 export const runSolutionsSearch = async (query) => {
     if (!loadCredentials()) {
         console.error(chalk.red('Not logged in. Run bitcompass login.'));
@@ -54,28 +50,28 @@ export const runSolutionsPull = async (id, options) => {
         ]);
         targetId = choice.id;
     }
-    const rule = await getRuleById(targetId);
-    if (!rule) {
-        console.error(chalk.red('Solution not found.'));
-        process.exit(1);
-    }
-    let outDir;
-    if (options?.global) {
-        // Use global location: ~/.cursor/rules/
-        outDir = join(homedir(), '.cursor', 'rules');
-    }
-    else {
-        // Use project config (default behavior)
-        const { outputPath } = getProjectConfig({ warnIfMissing: true });
-        outDir = join(process.cwd(), outputPath);
+    const spinner = ora('Pulling solution…').start();
+    try {
+        const filename = await pullRuleToFile(targetId, {
+            global: options?.global,
+            useSymlink: !options?.copy, // Use symlink unless --copy flag is set
+        });
+        spinner.succeed(chalk.green('Pulled solution'));
+        console.log(chalk.dim(filename));
+        if (options?.copy) {
+            console.log(chalk.dim('Copied as file (not a symlink)'));
+        }
+        else {
+            console.log(chalk.dim('Created symbolic link to cached solution'));
+        }
+        if (options?.global) {
+            console.log(chalk.dim('Installed globally for all projects'));
+        }
     }
-    mkdirSync(outDir, { recursive: true });
-    const filename = join(outDir, solutionFilename(rule.title, rule.id));
-    const content = `# ${rule.title}\n\n${rule.description}\n\n## Solution\n\n${rule.body}\n`;
-    writeFileSync(filename, content);
-    console.log(chalk.green('Wrote'), filename);
-    if (options?.global) {
-        console.log(chalk.dim('Installed globally for all projects'));
+    catch (error) {
+        spinner.fail(chalk.red('Failed to pull solution'));
+        console.error(chalk.red(error.message));
+        process.exit(1);
     }
 };
 export const runSolutionsPush = async (file) => {

package/dist/index.js

@@ -13,6 +13,8 @@ import { runMcpStart, runMcpStatus } from './commands/mcp.js';
 import { runLog } from './commands/log.js';
 import { runRulesList, runRulesPull, runRulesPush, runRulesSearch } from './commands/rules.js';
 import { runSolutionsPull, runSolutionsPush, runSolutionsSearch } from './commands/solutions.js';
+import { runSkillsList, runSkillsPull, runSkillsPush, runSkillsSearch } from './commands/skills.js';
+import { runCommandsList, runCommandsPull, runCommandsPush, runCommandsSearch } from './commands/commands.js';
 import { runWhoami } from './commands/whoami.js';
 // Read version from package.json
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -55,8 +57,9 @@ rules.command('search [query]').description('Search rules').action((query) => ru
 rules.command('list').description('List rules').action(() => runRulesList().catch(handleErr));
 rules
     .command('pull [id]')
-    .description('Pull a rule by ID or choose from list')
+    .description('Pull a rule by ID or choose from list (creates symbolic link by default)')
     .option('-g, --global', 'Install globally to ~/.cursor/rules/ for all projects')
+    .option('--copy', 'Copy file instead of creating symbolic link')
     .action((id, options) => runRulesPull(id, options).catch(handleErr));
 rules.command('push [file]').description('Push a rule (file or interactive)').action((file) => runRulesPush(file).catch(handleErr));
 // solutions
@@ -64,10 +67,33 @@ const solutions = program.command('solutions').description('Manage solutions');
 solutions.command('search [query]').description('Search solutions').action((query) => runSolutionsSearch(query).catch(handleErr));
 solutions
     .command('pull [id]')
-    .description('Pull a solution by ID or choose from list')
+    .description('Pull a solution by ID or choose from list (creates symbolic link by default)')
     .option('-g, --global', 'Install globally to ~/.cursor/rules/ for all projects')
+    .option('--copy', 'Copy file instead of creating symbolic link')
     .action((id, options) => runSolutionsPull(id, options).catch(handleErr));
 solutions.command('push [file]').description('Push a solution (file or interactive)').action((file) => runSolutionsPush(file).catch(handleErr));
+// skills
+const skills = program.command('skills').description('Manage skills');
+skills.command('search [query]').description('Search skills').action((query) => runSkillsSearch(query).catch(handleErr));
+skills.command('list').description('List skills').action(() => runSkillsList().catch(handleErr));
+skills
+    .command('pull [id]')
+    .description('Pull a skill by ID or choose from list (creates symbolic link by default)')
+    .option('-g, --global', 'Install globally to ~/.cursor/rules/ for all projects')
+    .option('--copy', 'Copy file instead of creating symbolic link')
+    .action((id, options) => runSkillsPull(id, options).catch(handleErr));
+skills.command('push [file]').description('Push a skill (file or interactive)').action((file) => runSkillsPush(file).catch(handleErr));
+// commands
+const commands = program.command('commands').description('Manage commands');
+commands.command('search [query]').description('Search commands').action((query) => runCommandsSearch(query).catch(handleErr));
+commands.command('list').description('List commands').action(() => runCommandsList().catch(handleErr));
+commands
+    .command('pull [id]')
+    .description('Pull a command by ID or choose from list (creates symbolic link by default)')
+    .option('-g, --global', 'Install globally to ~/.cursor/rules/ for all projects')
+    .option('--copy', 'Copy file instead of creating symbolic link')
+    .action((id, options) => runCommandsPull(id, options).catch(handleErr));
+commands.command('push [file]').description('Push a command (file or interactive)').action((file) => runCommandsPush(file).catch(handleErr));
 // mcp
 const mcp = program.command('mcp').description('MCP server');
 mcp.command('start').description('Start MCP server (stdio)').action(() => runMcpStart().catch(handleErr));

package/dist/lib/rule-cache.d.ts

@@ -0,0 +1,14 @@
+import type { Rule } from '../types.js';
+/**
+ * Gets the cache directory for rules (~/.bitcompass/cache/rules/)
+ */
+export declare const getCacheDir: () => string;
+/**
+ * Gets the cached file path for a rule by ID
+ */
+export declare const getCachedRulePath: (rule: Rule) => string;
+/**
+ * Ensures a rule is cached. Downloads and caches it if not present or outdated.
+ * Returns the path to the cached file.
+ */
+export declare const ensureRuleCached: (id: string) => Promise<string>;

package/dist/lib/rule-cache.js

@@ -0,0 +1,58 @@
+import { existsSync, mkdirSync, writeFileSync, statSync } from 'fs';
+import { join } from 'path';
+import { getConfigDir } from '../auth/config.js';
+import { getRuleById } from '../api/client.js';
+import { ruleFilename, solutionFilename } from './slug.js';
+/**
+ * Gets the cache directory for rules (~/.bitcompass/cache/rules/)
+ */
+export const getCacheDir = () => {
+    const cacheDir = join(getConfigDir(), 'cache', 'rules');
+    if (!existsSync(cacheDir)) {
+        mkdirSync(cacheDir, { mode: 0o755, recursive: true });
+    }
+    return cacheDir;
+};
+/**
+ * Gets the cached file path for a rule by ID
+ */
+export const getCachedRulePath = (rule) => {
+    const cacheDir = getCacheDir();
+    const filename = rule.kind === 'solution'
+        ? solutionFilename(rule.title, rule.id)
+        : ruleFilename(rule.title, rule.id);
+    return join(cacheDir, `${rule.id}-${filename}`);
+};
+/**
+ * Ensures a rule is cached. Downloads and caches it if not present or outdated.
+ * Returns the path to the cached file.
+ */
+export const ensureRuleCached = async (id) => {
+    const rule = await getRuleById(id);
+    if (!rule) {
+        throw new Error(`Rule or solution with ID ${id} not found.`);
+    }
+    const cachedPath = getCachedRulePath(rule);
+    const needsUpdate = !existsSync(cachedPath) || isCacheOutdated(cachedPath, rule);
+    if (needsUpdate) {
+        const content = rule.kind === 'solution'
+            ? `# ${rule.title}\n\n${rule.description}\n\n## Solution\n\n${rule.body}\n`
+            : `# ${rule.title}\n\n${rule.description}\n\n${rule.body}\n`;
+        writeFileSync(cachedPath, content, 'utf-8');
+    }
+    return cachedPath;
+};
+/**
+ * Checks if the cached file is outdated compared to the rule's updated_at timestamp
+ */
+const isCacheOutdated = (cachedPath, rule) => {
+    try {
+        const stats = statSync(cachedPath);
+        const cacheTime = stats.mtime.getTime();
+        const ruleTime = new Date(rule.updated_at).getTime();
+        return ruleTime > cacheTime;
+    }
+    catch {
+        return true; // If we can't read the file, consider it outdated
+    }
+};

package/dist/lib/rule-file-ops.d.ts

@@ -3,9 +3,12 @@ export interface PullRuleOptions {
     global?: boolean;
     /** Custom output path (overrides project config and global) */
     outputPath?: string;
+    /** Use symbolic links instead of copying files (default: true) */
+    useSymlink?: boolean;
 }
 /**
- * Pulls a rule or solution to a file. Returns the file path where it was written.
+ * Pulls a rule or solution to a file using symbolic links (like Bun init).
+ * Returns the file path where it was written/linked.
  * Throws if rule not found or if authentication is required.
  */
 export declare const pullRuleToFile: (id: string, options?: PullRuleOptions) => Promise<string>;

package/dist/lib/rule-file-ops.js

@@ -1,14 +1,19 @@
-import { mkdirSync, writeFileSync } from 'fs';
-import { join } from 'path';
+import { existsSync, mkdirSync, symlinkSync, unlinkSync, writeFileSync, lstatSync } from 'fs';
+import { join, relative, dirname } from 'path';
 import { homedir } from 'os';
 import { getRuleById } from '../api/client.js';
 import { getProjectConfig } from '../auth/project-config.js';
-import { ruleFilename, solutionFilename } from './slug.js';
+import { ruleFilename, solutionFilename, skillFilename, commandFilename } from './slug.js';
+import { ensureRuleCached } from './rule-cache.js';
 /**
- * Pulls a rule or solution to a file. Returns the file path where it was written.
+ * Pulls a rule or solution to a file using symbolic links (like Bun init).
+ * Returns the file path where it was written/linked.
  * Throws if rule not found or if authentication is required.
  */
 export const pullRuleToFile = async (id, options = {}) => {
+    const useSymlink = options.useSymlink !== false; // Default to true
+    // Ensure rule is cached in central location
+    const cachedPath = await ensureRuleCached(id);
     const rule = await getRuleById(id);
     if (!rule) {
         throw new Error(`Rule or solution with ID ${id} not found.`);
@@ -28,12 +33,70 @@ export const pullRuleToFile = async (id, options = {}) => {
         outDir = join(process.cwd(), outputPath);
     }
     mkdirSync(outDir, { recursive: true });
-    const filename = rule.kind === 'solution'
-        ? join(outDir, solutionFilename(rule.title, rule.id))
-        : join(outDir, ruleFilename(rule.title, rule.id));
-    const content = rule.kind === 'solution'
-        ? `# ${rule.title}\n\n${rule.description}\n\n## Solution\n\n${rule.body}\n`
-        : `# ${rule.title}\n\n${rule.description}\n\n${rule.body}\n`;
-    writeFileSync(filename, content);
+    let filename;
+    switch (rule.kind) {
+        case 'solution':
+            filename = join(outDir, solutionFilename(rule.title, rule.id));
+            break;
+        case 'skill':
+            filename = join(outDir, skillFilename(rule.title, rule.id));
+            break;
+        case 'command':
+            filename = join(outDir, commandFilename(rule.title, rule.id));
+            break;
+        case 'rule':
+        default:
+            filename = join(outDir, ruleFilename(rule.title, rule.id));
+            break;
+    }
+    // Remove existing file/symlink if it exists
+    if (existsSync(filename)) {
+        try {
+            const stats = lstatSync(filename);
+            if (stats.isSymbolicLink() || stats.isFile()) {
+                unlinkSync(filename);
+            }
+        }
+        catch {
+            // Ignore errors when removing
+        }
+    }
+    if (useSymlink) {
+        // Create symbolic link to cached file
+        // Use relative path for portability
+        const relativePath = relative(dirname(filename), cachedPath);
+        try {
+            symlinkSync(relativePath, filename);
+        }
+        catch (error) {
+            // Fallback to absolute path if relative fails (e.g., on Windows or cross-filesystem)
+            if (error.code === 'ENOENT' || error.code === 'EXDEV') {
+                symlinkSync(cachedPath, filename);
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    else {
+        // Fallback: copy file content (for compatibility or when symlinks aren't desired)
+        let content;
+        switch (rule.kind) {
+            case 'solution':
+                content = `# ${rule.title}\n\n${rule.description}\n\n## Solution\n\n${rule.body}\n`;
+                break;
+            case 'skill':
+                content = `# ${rule.title}\n\n${rule.description}\n\n${rule.body}\n`;
+                break;
+            case 'command':
+                content = `# ${rule.title}\n\n${rule.description}\n\n${rule.body}\n`;
+                break;
+            case 'rule':
+            default:
+                content = `# ${rule.title}\n\n${rule.description}\n\n${rule.body}\n`;
+                break;
+        }
+        writeFileSync(filename, content);
+    }
     return filename;
 };

package/dist/lib/slug.d.ts

@@ -13,3 +13,13 @@ export declare const ruleFilename: (title: string, id: string) => string;
  * Falls back to id if slug is empty.
  */
 export declare const solutionFilename: (title: string, id: string) => string;
+/**
+ * Returns the skill filename (e.g. skill-strava-api-authentication-flow.md).
+ * Falls back to id if slug is empty.
+ */
+export declare const skillFilename: (title: string, id: string) => string;
+/**
+ * Returns the command filename (e.g. command-strava-api-authentication-flow.md).
+ * Falls back to id if slug is empty.
+ */
+export declare const commandFilename: (title: string, id: string) => string;

package/dist/lib/slug.js

@@ -31,3 +31,21 @@ export const solutionFilename = (title, id) => {
     const base = slug ? `solution-${slug}` : `solution-${id}`;
     return `${base}.md`;
 };
+/**
+ * Returns the skill filename (e.g. skill-strava-api-authentication-flow.md).
+ * Falls back to id if slug is empty.
+ */
+export const skillFilename = (title, id) => {
+    const slug = titleToSlug(title);
+    const base = slug ? `skill-${slug}` : `skill-${id}`;
+    return `${base}.md`;
+};
+/**
+ * Returns the command filename (e.g. command-strava-api-authentication-flow.md).
+ * Falls back to id if slug is empty.
+ */
+export const commandFilename = (title, id) => {
+    const slug = titleToSlug(title);
+    const base = slug ? `command-${slug}` : `command-${id}`;
+    return `${base}.md`;
+};

package/dist/types.d.ts

@@ -10,6 +10,7 @@ export interface Rule {
     technologies?: string[];
     user_id: string;
     author_display_name?: string | null;
+    version?: string | null;
     created_at: string;
     updated_at: string;
 }
@@ -21,6 +22,7 @@ export interface RuleInsert {
     context?: string | null;
     examples?: string[];
     technologies?: string[];
+    version?: string;
 }
 export interface StoredCredentials {
     access_token: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitcompass",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "BitCompass CLI - rules, solutions, and MCP server",
   "type": "module",
   "bin": {