bitcompass 0.2.7 → 0.2.9

package/dist/commands/rules.d.ts

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

package/dist/commands/rules.js

@@ -3,9 +3,11 @@ 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';
 export const runRulesSearch = async (query) => {
     if (!loadCredentials()) {
         console.error(chalk.red('Not logged in. Run bitcompass login.'));
@@ -45,7 +47,7 @@ export const runRulesList = async () => {
     if (list.length === 0)
         console.log(chalk.yellow('No rules yet.'));
 };
-export const runRulesPull = async (id) => {
+export const runRulesPull = async (id, options) => {
     if (!loadCredentials()) {
         console.error(chalk.red('Not logged in. Run bitcompass login.'));
         process.exit(1);
@@ -69,13 +71,24 @@ export const runRulesPull = async (id) => {
         console.error(chalk.red('Rule not found.'));
         process.exit(1);
     }
-    const { outputPath } = getProjectConfig({ warnIfMissing: true });
-    const outDir = join(process.cwd(), outputPath);
+    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);
+    }
     mkdirSync(outDir, { recursive: true });
-    const filename = join(outDir, `rule-${rule.id}.md`);
+    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'));
+    }
 };
 export const runRulesPush = async (file) => {
     if (!loadCredentials()) {

package/dist/commands/solutions.d.ts

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

package/dist/commands/solutions.js

@@ -3,9 +3,11 @@ 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';
 export const runSolutionsSearch = async (query) => {
     if (!loadCredentials()) {
         console.error(chalk.red('Not logged in. Run bitcompass login.'));
@@ -33,7 +35,7 @@ export const runSolutionsSearch = async (query) => {
         console.log(rule.body);
     }
 };
-export const runSolutionsPull = async (id) => {
+export const runSolutionsPull = async (id, options) => {
     if (!loadCredentials()) {
         console.error(chalk.red('Not logged in. Run bitcompass login.'));
         process.exit(1);
@@ -57,13 +59,24 @@ export const runSolutionsPull = async (id) => {
         console.error(chalk.red('Solution not found.'));
         process.exit(1);
     }
-    const { outputPath } = getProjectConfig({ warnIfMissing: true });
-    const outDir = join(process.cwd(), outputPath);
+    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);
+    }
     mkdirSync(outDir, { recursive: true });
-    const filename = join(outDir, `solution-${rule.id}.md`);
+    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'));
+    }
 };
 export const runSolutionsPush = async (file) => {
     if (!loadCredentials()) {

package/dist/index.js

@@ -45,12 +45,20 @@ configCmd.command('get <key>').description('Get a config value').action((key) =>
 const rules = program.command('rules').description('Manage rules');
 rules.command('search [query]').description('Search rules').action((query) => runRulesSearch(query).catch(handleErr));
 rules.command('list').description('List rules').action(() => runRulesList().catch(handleErr));
-rules.command('pull [id]').description('Pull a rule by ID or choose from list').action((id) => runRulesPull(id).catch(handleErr));
+rules
+    .command('pull [id]')
+    .description('Pull a rule by ID or choose from list')
+    .option('-g, --global', 'Install globally to ~/.cursor/rules/ for all projects')
+    .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
 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').action((id) => runSolutionsPull(id).catch(handleErr));
+solutions
+    .command('pull [id]')
+    .description('Pull a solution by ID or choose from list')
+    .option('-g, --global', 'Install globally to ~/.cursor/rules/ for all projects')
+    .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));
 // mcp
 const mcp = program.command('mcp').description('MCP server');

package/dist/lib/slug.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts a rule/solution title to a standardized filename slug.
+ * e.g. "# Strava API Authentication Flow" -> "strava-api-authentication-flow"
+ */
+export declare const titleToSlug: (title: string) => string;
+/**
+ * Returns the rule filename (e.g. rule-strava-api-authentication-flow.md).
+ * Falls back to id if slug is empty.
+ */
+export declare const ruleFilename: (title: string, id: string) => string;
+/**
+ * Returns the solution filename (e.g. solution-strava-api-authentication-flow.md).
+ * Falls back to id if slug is empty.
+ */
+export declare const solutionFilename: (title: string, id: string) => string;

package/dist/lib/slug.js

@@ -0,0 +1,33 @@
+/**
+ * Converts a rule/solution title to a standardized filename slug.
+ * e.g. "# Strava API Authentication Flow" -> "strava-api-authentication-flow"
+ */
+export const titleToSlug = (title) => {
+    const trimmed = (title ?? '').trim().replace(/^#\s*/, '');
+    if (!trimmed)
+        return '';
+    return trimmed
+        .toLowerCase()
+        .replace(/\s+/g, '-')
+        .replace(/[^a-z0-9-]/g, '')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+};
+/**
+ * Returns the rule filename (e.g. rule-strava-api-authentication-flow.md).
+ * Falls back to id if slug is empty.
+ */
+export const ruleFilename = (title, id) => {
+    const slug = titleToSlug(title);
+    const base = slug ? `rule-${slug}` : `rule-${id}`;
+    return `${base}.md`;
+};
+/**
+ * Returns the solution filename (e.g. solution-strava-api-authentication-flow.md).
+ * Falls back to id if slug is empty.
+ */
+export const solutionFilename = (title, id) => {
+    const slug = titleToSlug(title);
+    const base = slug ? `solution-${slug}` : `solution-${id}`;
+    return `${base}.md`;
+};

package/package.json

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