bitcompass 0.3.9 → 0.4.1

package/dist/commands/solutions.js

@@ -2,9 +2,10 @@ 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 { searchRules, fetchRules, getRuleById } from '../api/client.js';
 import { pullRuleToFile } from '../lib/rule-file-ops.js';
 import { formatList, shouldUseTable } from '../lib/list-format.js';
+import { runSharePush } from './share.js';
 export const runSolutionsSearch = async (query, options) => {
     if (!loadCredentials()) {
         console.error(chalk.red('Not logged in. Run bitcompass login.'));
@@ -95,35 +96,6 @@ export const runSolutionsPull = async (id, options) => {
         process.exit(message.includes('not found') ? 2 : 1);
     }
 };
-export const runSolutionsPush = 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 = 'solution';
-        }
-        catch {
-            const lines = raw.split('\n');
-            const title = lines[0].replace(/^#\s*/, '') || 'Untitled';
-            payload = { kind: 'solution', title, description: '', body: raw };
-        }
-    }
-    else {
-        const answers = await inquirer.prompt([
-            { name: 'title', message: 'Problem title', type: 'input', default: 'Untitled' },
-            { name: 'description', message: 'Description', type: 'input', default: '' },
-            { name: 'body', message: 'Solution content', type: 'editor', default: '' },
-        ]);
-        payload = { kind: 'solution', title: answers.title, description: answers.description, body: answers.body };
-    }
-    const spinner = ora('Publishing solution…').start();
-    const created = await insertRule(payload);
-    spinner.succeed(chalk.green('Published solution ') + created.id);
-    console.log(chalk.dim(created.title));
+export const runSolutionsPush = async (file, options) => {
+    await runSharePush(file, { kind: 'solution', projectId: options?.projectId });
 };

package/dist/commands/whoami.js

@@ -1,4 +1,4 @@
-import { loadCredentials } from '../auth/config.js';
+import { getCurrentUserEmail, loadCredentials } from '../auth/config.js';
 import chalk from 'chalk';
 export const runWhoami = () => {
     const creds = loadCredentials();
@@ -6,7 +6,7 @@ export const runWhoami = () => {
         console.error(chalk.red('Not logged in. Run bitcompass login.'));
         process.exit(1);
     }
-    const email = creds.user?.email;
+    const email = getCurrentUserEmail();
     if (email) {
         console.log(email);
     }

package/dist/index.js

@@ -5,17 +5,18 @@ import { Command } from 'commander';
 import { readFileSync } from 'fs';
 import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
+import { runCommandsList, runCommandsPull, runCommandsPush, runCommandsSearch } from './commands/commands.js';
 import { runConfigGet, runConfigList, runConfigSet } from './commands/config-cmd.js';
+import { runGlossary } from './commands/glossary.js';
 import { runInit } from './commands/init.js';
+import { runLog, ValidationError } from './commands/log.js';
 import { runLogin } from './commands/login.js';
 import { runLogout } from './commands/logout.js';
 import { runMcpStart, runMcpStatus } from './commands/mcp.js';
-import { runLog, ValidationError } from './commands/log.js';
 import { runRulesList, runRulesPull, runRulesPush, runRulesSearch } from './commands/rules.js';
-import { runSolutionsList, runSolutionsPull, runSolutionsPush, runSolutionsSearch } from './commands/solutions.js';
+import { runSharePush } from './commands/share.js';
 import { runSkillsList, runSkillsPull, runSkillsPush, runSkillsSearch } from './commands/skills.js';
-import { runCommandsList, runCommandsPull, runCommandsPush, runCommandsSearch } from './commands/commands.js';
-import { runGlossary } from './commands/glossary.js';
+import { runSolutionsList, runSolutionsPull, runSolutionsPush, runSolutionsSearch } from './commands/solutions.js';
 import { runWhoami } from './commands/whoami.js';
 // Disable chalk colors when NO_COLOR is set or --no-color is passed (must run before any command)
 if (process.env.NO_COLOR !== undefined || process.argv.includes('--no-color')) {
@@ -48,6 +49,25 @@ program
     .command('glossary')
     .description('Show glossary (rules, solutions, skills, commands)')
     .action(runGlossary);
+program
+    .command('share [file]')
+    .description('Share a rule, solution, skill, or command (prompts for type if not in file or --kind)')
+    .option('-k, --kind <kind>', 'Type: rule, solution, skill, or command (skips type prompt)')
+    .option('--project-id <uuid>', 'Scope to Compass project (UUID)')
+    .addHelpText('after', `
+Examples:
+  bitcompass share
+  bitcompass share ./my-rule.mdc
+  bitcompass share ./doc.md --kind solution
+`)
+    .action((file, opts) => {
+    const kind = opts?.kind;
+    if (opts?.kind && kind !== 'rule' && kind !== 'solution' && kind !== 'skill' && kind !== 'command') {
+        console.error(chalk.red('--kind must be one of: rule, solution, skill, command'));
+        process.exit(1);
+    }
+    return runSharePush(file, { kind, projectId: opts?.projectId }).catch(handleErr);
+});
 program
     .command('init')
     .description('Configure project: editor/AI provider and output folder for rules/docs/commands')
@@ -93,7 +113,11 @@ rules
     .option('--copy', 'Copy file instead of creating symbolic link')
     .addHelpText('after', '\nExamples:\n  bitcompass rules pull <id>\n  bitcompass rules pull <id> --global\n  bitcompass rules pull <id> --copy\n')
     .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));
+rules
+    .command('push [file]')
+    .description('Push a rule (file or interactive)')
+    .option('--project-id <uuid>', 'Scope to Compass project (UUID)')
+    .action((file, opts) => runRulesPush(file, { projectId: opts?.projectId }).catch(handleErr));
 // solutions
 const solutions = program.command('solutions').description('Manage solutions');
 solutions
@@ -114,7 +138,11 @@ solutions
     .option('--copy', 'Copy file instead of creating symbolic link')
     .addHelpText('after', '\nExamples:\n  bitcompass solutions pull <id>\n  bitcompass solutions pull <id> --global\n')
     .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));
+solutions
+    .command('push [file]')
+    .description('Push a solution (file or interactive)')
+    .option('--project-id <uuid>', 'Scope to Compass project (UUID)')
+    .action((file, opts) => runSolutionsPush(file, { projectId: opts?.projectId }).catch(handleErr));
 // skills
 const skills = program.command('skills').description('Manage skills');
 skills
@@ -135,7 +163,11 @@ skills
     .option('--copy', 'Copy file instead of creating symbolic link')
     .addHelpText('after', '\nExamples:\n  bitcompass skills pull <id>\n  bitcompass skills pull <id> --global\n')
     .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));
+skills
+    .command('push [file]')
+    .description('Push a skill (file or interactive)')
+    .option('--project-id <uuid>', 'Scope to Compass project (UUID)')
+    .action((file, opts) => runSkillsPush(file, { projectId: opts?.projectId }).catch(handleErr));
 // commands
 const commands = program.command('commands').description('Manage commands');
 commands
@@ -156,7 +188,11 @@ commands
     .option('--copy', 'Copy file instead of creating symbolic link')
     .addHelpText('after', '\nExamples:\n  bitcompass commands pull <id>\n  bitcompass commands pull <id> --global\n')
     .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));
+commands
+    .command('push [file]')
+    .description('Push a command (file or interactive)')
+    .option('--project-id <uuid>', 'Scope to Compass project (UUID)')
+    .action((file, opts) => runCommandsPush(file, { projectId: opts?.projectId }).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/banner.d.ts

@@ -0,0 +1,15 @@
+type Rgb = [number, number, number];
+/**
+ * Renders text with a gradient between two RGB colors.
+ */
+export declare const gradient: (text: string, start: Rgb, end: Rgb) => string;
+/**
+ * Glow effect: gradient that peaks in the middle (bright center, dimmer edges).
+ */
+export declare const glow: (text: string, baseColor: Rgb) => string;
+/**
+ * Prints the same version + "made by" banner as postinstall (for bitcompass init).
+ * Reads version from package.json next to dist/.
+ */
+export declare const printBanner: () => Promise<void>;
+export {};

package/dist/lib/banner.js

@@ -0,0 +1,82 @@
+import chalk from 'chalk';
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+/**
+ * Renders text with a gradient between two RGB colors.
+ */
+export const gradient = (text, start, end) => [...text]
+    .map((char, i) => {
+    const t = text.length > 1 ? i / (text.length - 1) : 1;
+    const [r1, g1, b1] = start;
+    const [r2, g2, b2] = end;
+    const r = Math.round(r1 + (r2 - r1) * t);
+    const g = Math.round(g1 + (g2 - g1) * t);
+    const b = Math.round(b1 + (b2 - b1) * t);
+    return chalk.rgb(r, g, b)(char);
+})
+    .join('');
+/**
+ * Glow effect: gradient that peaks in the middle (bright center, dimmer edges).
+ */
+export const glow = (text, baseColor) => [...text]
+    .map((char, i) => {
+    const t = text.length > 1 ? i / (text.length - 1) : 1;
+    const peak = 1 - 4 * (t - 0.5) * (t - 0.5);
+    const mult = 0.4 + 0.6 * Math.max(0, peak);
+    const [r, g, b] = baseColor;
+    const R = Math.round(r * mult);
+    const G = Math.round(g * mult);
+    const B = Math.round(b * mult);
+    return chalk.rgb(R, G, B)(char);
+})
+    .join('');
+const cyan = [0, 212, 255];
+const magenta = [255, 64, 200];
+const glowColor = [255, 120, 255];
+const PREFIX = 'made by ';
+const AUTHOR = '@davide97g';
+const GITHUB_URL = 'https://github.com/davide97g/';
+/** OSC 8 hyperlink for supported terminals. */
+const link = (url, text) => `\x1b]8;;${url}\x1b\\${text}\x1b]8;;\x1b\\`;
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Prints the same version + "made by" banner as postinstall (for bitcompass init).
+ * Reads version from package.json next to dist/.
+ */
+export const printBanner = async () => {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const pkgPath = join(__dirname, '..', '..', 'package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    const version = pkg.version ?? '0.0.0';
+    const out = process.stdout;
+    const isTty = out.isTTY;
+    const frames = 6;
+    const frameMs = 80;
+    out.write('\n');
+    out.write(gradient(`version ${version}`, cyan, magenta) + '\n');
+    if (!isTty) {
+        out.write(PREFIX + link(GITHUB_URL, glow(AUTHOR, glowColor)) + '\n');
+        out.write('\n');
+        return;
+    }
+    for (let f = 0; f < frames; f++) {
+        const t = f / (frames - 1);
+        const brightness = 0.3 + 0.7 * (1 - Math.cos(t * Math.PI));
+        const styledAuthor = [...AUTHOR]
+            .map((char, i) => {
+            const ti = AUTHOR.length > 1 ? i / (AUTHOR.length - 1) : 1;
+            const peak = 1 - 4 * (ti - 0.5) * (ti - 0.5);
+            const mult = (0.4 + 0.6 * Math.max(0, peak)) * brightness;
+            const [r, g, b] = glowColor;
+            return chalk.rgb(Math.round(r * Math.min(1, mult)), Math.round(g * Math.min(1, mult)), Math.round(b * Math.min(1, mult)))(char);
+        })
+            .join('');
+        const line = PREFIX + link(GITHUB_URL, styledAuthor);
+        out.write('\r\x1b[K' + line);
+        await sleep(frameMs);
+    }
+    const finalLine = PREFIX + link(GITHUB_URL, glow(AUTHOR, glowColor));
+    out.write('\r\x1b[K' + finalLine + '\n');
+    out.write('\n');
+};

package/dist/lib/mdc-format.d.ts

@@ -1,12 +1,18 @@
-import type { Rule } from '../types.js';
+import type { Rule, RuleKind } from '../types.js';
 /**
- * Builds Cursor .mdc content for a rule: YAML frontmatter (description, globs, alwaysApply) then body.
+ * Builds Cursor .mdc content for a rule: YAML frontmatter (description, globs, alwaysApply, kind) then body.
  */
 export declare const buildRuleMdcContent: (rule: Rule) => string;
+/**
+ * Builds .md content for solution, skill, or command with frontmatter (kind, description)
+ * so that bitcompass share can infer kind when re-pushing.
+ */
+export declare const buildMarkdownWithKind: (rule: Rule) => string;
 export interface ParsedMdcFrontmatter {
     description: string;
     globs?: string;
     alwaysApply: boolean;
+    kind?: RuleKind;
     body: string;
 }
 /**
@@ -14,3 +20,8 @@ export interface ParsedMdcFrontmatter {
  * Returns null if the file does not start with --- (not frontmatter format).
  */
 export declare const parseRuleMdcContent: (raw: string) => ParsedMdcFrontmatter | null;
+/**
+ * Returns kind from the first frontmatter block if present and valid.
+ * Use for .md or .mdc files when you only need kind (e.g. solution/skill/command round-trip).
+ */
+export declare const parseFrontmatterKind: (raw: string) => RuleKind | null;

package/dist/lib/mdc-format.js

@@ -1,9 +1,11 @@
+import { isValidRuleKind } from './share-types.js';
 const FRONTMATTER_DELIM = '---';
 /**
- * Builds Cursor .mdc content for a rule: YAML frontmatter (description, globs, alwaysApply) then body.
+ * Builds Cursor .mdc content for a rule: YAML frontmatter (description, globs, alwaysApply, kind) then body.
  */
 export const buildRuleMdcContent = (rule) => {
     const lines = [FRONTMATTER_DELIM];
+    lines.push(`kind: ${rule.kind}`);
     lines.push(`description: ${escapeYamlValue(rule.description ?? '')}`);
     if (rule.globs != null && String(rule.globs).trim() !== '') {
         lines.push(`globs: ${escapeYamlValue(String(rule.globs).trim())}`);
@@ -17,6 +19,35 @@ export const buildRuleMdcContent = (rule) => {
     }
     return lines.join('\n');
 };
+/**
+ * Builds .md content for solution, skill, or command with frontmatter (kind, description)
+ * so that bitcompass share can infer kind when re-pushing.
+ */
+export const buildMarkdownWithKind = (rule) => {
+    if (rule.kind === 'rule') {
+        return buildRuleMdcContent(rule);
+    }
+    const lines = [FRONTMATTER_DELIM];
+    lines.push(`kind: ${rule.kind}`);
+    lines.push(`description: ${escapeYamlValue(rule.description ?? '')}`);
+    lines.push(FRONTMATTER_DELIM);
+    lines.push('');
+    lines.push(`# ${rule.title}`);
+    lines.push('');
+    if (rule.description) {
+        lines.push(rule.description);
+        lines.push('');
+    }
+    if (rule.kind === 'solution') {
+        lines.push('## Solution');
+        lines.push('');
+    }
+    lines.push(rule.body.trimEnd());
+    if (!rule.body.endsWith('\n')) {
+        lines.push('');
+    }
+    return lines.join('\n');
+};
 const escapeYamlValue = (s) => {
     if (/^[a-z0-9-]+$/i.test(s) && !s.includes(':'))
         return s;
@@ -41,6 +72,7 @@ export const parseRuleMdcContent = (raw) => {
     let description = '';
     let globs;
     let alwaysApply = false;
+    let kind;
     for (const line of frontmatterBlock.split('\n')) {
         const colonIdx = line.indexOf(':');
         if (colonIdx === -1)
@@ -60,7 +92,19 @@ export const parseRuleMdcContent = (raw) => {
             case 'alwaysApply':
                 alwaysApply = value === 'true' || value === '1';
                 break;
+            case 'kind':
+                if (isValidRuleKind(value))
+                    kind = value;
+                break;
         }
     }
-    return { description, globs, alwaysApply, body };
+    return { description, globs, alwaysApply, kind, body };
+};
+/**
+ * Returns kind from the first frontmatter block if present and valid.
+ * Use for .md or .mdc files when you only need kind (e.g. solution/skill/command round-trip).
+ */
+export const parseFrontmatterKind = (raw) => {
+    const parsed = parseRuleMdcContent(raw);
+    return parsed?.kind ?? null;
 };

package/dist/lib/rule-cache.js

@@ -3,7 +3,7 @@ import { join } from 'path';
 import { getConfigDir } from '../auth/config.js';
 import { getRuleById } from '../api/client.js';
 import { ruleFilename, solutionFilename, skillFilename, commandFilename } from './slug.js';
-import { buildRuleMdcContent } from './mdc-format.js';
+import { buildRuleMdcContent, buildMarkdownWithKind } from './mdc-format.js';
 /**
  * Gets the cache directory for rules (~/.bitcompass/cache/rules/)
  */
@@ -42,9 +42,7 @@ export const ensureRuleCached = async (id) => {
     if (needsUpdate) {
         const content = rule.kind === 'rule'
             ? buildRuleMdcContent(rule)
-            : 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`;
+            : buildMarkdownWithKind(rule);
         writeFileSync(cachedPath, content, 'utf-8');
     }
     return cachedPath;

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

@@ -5,7 +5,7 @@ import { getRuleById } from '../api/client.js';
 import { getProjectConfig } from '../auth/project-config.js';
 import { ruleFilename, solutionFilename, skillFilename, commandFilename } from './slug.js';
 import { ensureRuleCached } from './rule-cache.js';
-import { buildRuleMdcContent } from './mdc-format.js';
+import { buildRuleMdcContent, buildMarkdownWithKind } from './mdc-format.js';
 /**
  * Pulls a rule or solution to a file using symbolic links (like Bun init).
  * Returns the file path where it was written/linked.
@@ -80,12 +80,10 @@ export const pullRuleToFile = async (id, options = {}) => {
         }
     }
     else {
-        // Fallback: copy file content (rules as .mdc with frontmatter, others as .md)
+        // Fallback: copy file content (rules as .mdc with full frontmatter, others as .md with kind in frontmatter for round-trip)
         const content = rule.kind === 'rule'
             ? buildRuleMdcContent(rule)
-            : 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`;
+            : buildMarkdownWithKind(rule);
         writeFileSync(filename, content);
     }
     return filename;

package/dist/lib/share-types.d.ts

@@ -0,0 +1,12 @@
+import type { RuleKind } from '../types.js';
+export declare const SHARE_KIND_CHOICES: Array<{
+    value: RuleKind;
+    name: string;
+    description: string;
+}>;
+export declare const isValidRuleKind: (s: string) => s is RuleKind;
+/**
+ * Infers RuleKind from filename prefix (rule-*.mdc, solution-*.md, skill-*.md, command-*.md).
+ * Returns null if the basename does not match a known prefix.
+ */
+export declare const inferKindFromFilename: (filePath: string) => RuleKind | null;

package/dist/lib/share-types.js

@@ -0,0 +1,41 @@
+const VALID_KINDS = ['rule', 'solution', 'skill', 'command'];
+export const SHARE_KIND_CHOICES = [
+    {
+        value: 'rule',
+        name: 'Rule',
+        description: 'Behaviors, documentation, or how-to for the AI (e.g. i18n guide, coding standards)',
+    },
+    {
+        value: 'solution',
+        name: 'Solution',
+        description: 'How we fixed or implemented a specific problem',
+    },
+    {
+        value: 'skill',
+        name: 'Skill',
+        description: 'How the AI should behave in a domain (e.g. front-end design, back-end implementation)',
+    },
+    {
+        value: 'command',
+        name: 'Command (workflow)',
+        description: 'A workflow or command (e.g. release checklist)',
+    },
+];
+export const isValidRuleKind = (s) => VALID_KINDS.includes(s);
+/**
+ * Infers RuleKind from filename prefix (rule-*.mdc, solution-*.md, skill-*.md, command-*.md).
+ * Returns null if the basename does not match a known prefix.
+ */
+export const inferKindFromFilename = (filePath) => {
+    const base = filePath.split(/[/\\]/).pop() ?? '';
+    const lower = base.toLowerCase();
+    if (lower.startsWith('rule-') && (lower.endsWith('.mdc') || lower.endsWith('.md')))
+        return 'rule';
+    if (lower.startsWith('solution-') && (lower.endsWith('.md') || lower.endsWith('.mdc')))
+        return 'solution';
+    if (lower.startsWith('skill-') && (lower.endsWith('.md') || lower.endsWith('.mdc')))
+        return 'skill';
+    if (lower.startsWith('command-') && (lower.endsWith('.md') || lower.endsWith('.mdc')))
+        return 'command';
+    return null;
+};

package/dist/mcp/server.js

@@ -87,7 +87,7 @@ function createStdioServer() {
                             },
                             {
                                 name: 'post-rules',
-                                description: 'Use when the user wants to publish or share a new rule, solution, skill, or command to BitCompass. Requires kind, title, and body. Returns the created id and title on success. User must be logged in (bitcompass login).',
+                                description: 'Use when the user wants to publish or share a new rule, solution, skill, or command to BitCompass. Requires kind, title, and body. When the user says "share" without specifying type, first ask or infer: Rule (behaviors, docs), Solution (how we fixed something), Skill (how AI should behave for X), Command (workflows). Returns the created id and title on success. User must be logged in (bitcompass login).',
                                 inputSchema: {
                                     type: 'object',
                                     properties: {
@@ -98,6 +98,7 @@ function createStdioServer() {
                                         context: { type: 'string' },
                                         examples: { type: 'array', items: { type: 'string' } },
                                         technologies: { type: 'array', items: { type: 'string' } },
+                                        project_id: { type: 'string', description: 'Optional: Compass project UUID to scope this rule to' },
                                     },
                                     required: ['kind', 'title', 'body'],
                                 },
@@ -121,18 +122,18 @@ function createStdioServer() {
                                     type: 'object',
                                     properties: {
                                         id: { type: 'string', description: 'Rule/solution ID' },
-                                        kind: { type: 'string', enum: ['rule', 'solution'], description: 'Optional: filter by kind' },
+                                        kind: { type: 'string', enum: ['rule', 'solution', 'skill', 'command'], description: 'Optional: filter by kind' },
                                     },
                                     required: ['id'],
                                 },
                             },
                             {
                                 name: 'list-rules',
-                                description: 'Use when the user wants to browse or list all rules and/or solutions without a search query. Optional kind filter (rule or solution) and limit. Returns an array of items with id, title, kind, description, author, snippet, created_at, plus total/returned counts.',
+                                description: 'Use when the user wants to browse or list all rules, solutions, skills, or commands without a search query. Optional kind filter (rule, solution, skill, command) and limit. Returns an array of items with id, title, kind, description, author, snippet, created_at, plus total/returned counts.',
                                 inputSchema: {
                                     type: 'object',
                                     properties: {
-                                        kind: { type: 'string', enum: ['rule', 'solution'], description: 'Optional: filter by kind' },
+                                        kind: { type: 'string', enum: ['rule', 'solution', 'skill', 'command'], description: 'Optional: filter by kind' },
                                         limit: { type: 'number', description: 'Optional: maximum number of results (default: 50)' },
                                     },
                                 },
@@ -226,6 +227,7 @@ function createStdioServer() {
                     id,
                     result: {
                         prompts: [
+                            { name: 'share', title: 'Share something', description: 'Guide to publish a rule, solution, skill, or command. Asks what you\'re sharing, then collects content and publishes.' },
                             { name: 'share_new_rule', title: 'Share a new rule', description: 'Guide to collect and publish a reusable rule' },
                             { name: 'share_problem_solution', title: 'Share a problem solution', description: 'Guide to collect and publish a problem solution' },
                         ],
@@ -236,6 +238,30 @@ function createStdioServer() {
             if (msg.method === 'prompts/get') {
                 const params = msg.params;
                 const name = params?.name ?? '';
+                if (name === 'share') {
+                    send({
+                        jsonrpc: '2.0',
+                        id,
+                        result: {
+                            messages: [
+                                {
+                                    role: 'user',
+                                    content: {
+                                        type: 'text',
+                                        text: `You are helping the user share something to BitCompass. First determine what they are sharing. If they already said (e.g. "share this rule", "share this workflow"), use that; otherwise ask with a single choice:
+- Rule: Behaviors, documentation, or how-to for the AI (e.g. i18n guide, coding standards).
+- Solution: How we fixed or implemented a specific problem.
+- Skill: How the AI should behave in a domain (e.g. front-end design, back-end implementation).
+- Command (workflow): A workflow or command (e.g. release checklist).
+
+Then collect: title, description, body (and optionally context, examples, technologies). Ask one question at a time. Then call post-rules with the chosen kind and the collected fields.`,
+                                    },
+                                },
+                            ],
+                        },
+                    });
+                    return;
+                }
                 if (name === 'share_new_rule') {
                     send({
                         jsonrpc: '2.0',
@@ -352,6 +378,7 @@ function createStdioServer() {
             context: args.context || undefined,
             examples: Array.isArray(args.examples) ? args.examples : undefined,
             technologies: Array.isArray(args.technologies) ? args.technologies : undefined,
+            project_id: typeof args.project_id === 'string' ? args.project_id : undefined,
         };
         try {
             const created = await insertRule(payload);

package/dist/types.d.ts

@@ -10,6 +10,8 @@ export interface Rule {
     technologies?: string[];
     user_id: string;
     author_display_name?: string | null;
+    /** When set, rule is scoped to this Compass project. */
+    project_id?: string | null;
     version?: string | null;
     /** Optional glob patterns for when the rule applies (e.g. "*.ts, *.tsx"). Used in .mdc frontmatter. */
     globs?: string | null;
@@ -26,6 +28,7 @@ export interface RuleInsert {
     context?: string | null;
     examples?: string[];
     technologies?: string[];
+    project_id?: string | null;
     version?: string;
     globs?: string | null;
     always_apply?: boolean;

package/package.json

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

package/scripts/postinstall.js

@@ -65,25 +65,29 @@ const glowWithBrightness = (text, [r, g, b], brightness) =>
 
 const cyan = [0, 212, 255];
 const magenta = [255, 64, 200];
-const amber = [255, 190, 50];
 const glowColor = [255, 120, 255];
 
 const PREFIX = "made by ";
-const AUTHOR = "davide97g";
+const AUTHOR = "@davide97g";
 const GITHUB_URL = "https://github.com/davide97g/";
+const INIT_TIP =
+  chalk.dim("Run ") + chalk.cyan("bitcompass init") + chalk.dim(" in your project to configure.");
 
 /** Wraps text in OSC 8 hyperlink so it's clickable in supported terminals (VS Code, iTerm2, Windows Terminal). */
 const link = (url, text) => `\x1b]8;;${url}\x1b\\${text}\x1b]8;;\x1b\\`;
 
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
+/** npm v7+ runs lifecycle scripts in background and suppresses stdout. Write to stderr so the message is visible during `npm i bitcompass -g`. */
+const out = process.stderr;
+
 const animateAuthorLine = async () => {
-  const isTty = process.stdout.isTTY;
+  const isTty = out.isTTY;
   const frames = 6;
   const frameMs = 80;
 
   if (!isTty) {
-    console.log(PREFIX + link(GITHUB_URL, glow(AUTHOR, glowColor)));
+    out.write(PREFIX + link(GITHUB_URL, glow(AUTHOR, glowColor)) + "\n");
     return;
   }
 
@@ -92,16 +96,15 @@ const animateAuthorLine = async () => {
     const brightness = 0.3 + 0.7 * (1 - Math.cos(t * Math.PI));
     const styledAuthor = glowWithBrightness(AUTHOR, glowColor, brightness);
     const line = PREFIX + link(GITHUB_URL, styledAuthor);
-    process.stdout.write("\r\x1b[K" + line);
+    out.write("\r\x1b[K" + line);
     await sleep(frameMs);
   }
   const finalLine = PREFIX + link(GITHUB_URL, glow(AUTHOR, glowColor));
-  process.stdout.write("\r\x1b[K" + finalLine + "\n");
+  out.write("\r\x1b[K" + finalLine + "\n");
 };
 
-(async () => {
-  console.log("");
-  console.log(gradient(`version ${version}`, cyan, magenta));
-  await animateAuthorLine();
-  console.log("");
-})();
+out.write("\n");
+out.write(gradient(`version ${version}`, cyan, magenta) + "\n");
+await animateAuthorLine();
+out.write(INIT_TIP + "\n");
+out.write("\n");