bitcompass 0.3.8 → 0.4.0

package/dist/api/client.js

@@ -41,18 +41,7 @@ export const getSupabaseClient = () => {
     });
 };
 /** Client for public read-only (rules/solutions). Works without login when RLS allows public select. */
-export const getSupabaseClientForRead = () => {
-    const pair = getSupabaseUrlAndKey();
-    if (!pair)
-        return null;
-    const creds = loadCredentials();
-    const accessToken = creds?.access_token;
-    return createClient(pair.url, pair.key, {
-        global: accessToken
-            ? { headers: { Authorization: `Bearer ${accessToken}` } }
-            : undefined,
-    });
-};
+export const getSupabaseClientForRead = getSupabaseClient;
 export const fetchRules = async (kind) => {
     const client = getSupabaseClientForRead();
     if (!client)

package/dist/commands/commands.d.ts

@@ -8,4 +8,6 @@ export declare const runCommandsPull: (id?: string, options?: {
     global?: boolean;
     copy?: boolean;
 }) => Promise<void>;
-export declare const runCommandsPush: (file?: string) => Promise<void>;
+export declare const runCommandsPush: (file?: string, options?: {
+    projectId?: string;
+}) => Promise<void>;

package/dist/commands/commands.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 runCommandsSearch = async (query, options) => {
     if (!loadCredentials()) {
         console.error(chalk.red('Not logged in. Run bitcompass login.'));
@@ -95,35 +96,6 @@ export const runCommandsPull = async (id, options) => {
         process.exit(message.includes('not found') ? 2 : 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));
+export const runCommandsPush = async (file, options) => {
+    await runSharePush(file, { kind: 'command', projectId: options?.projectId });
 };

package/dist/commands/log.d.ts

@@ -1,5 +1,10 @@
 import type { TimeFrame } from '../lib/git-analysis.js';
 export type LogProgressStep = 'analyzing' | 'pushing';
+type PeriodBounds = {
+    period_start: string;
+    period_end: string;
+    since: string;
+};
 /**
  * Shared logic: resolve repo, compute period, gather summary + git analysis, insert log.
  * Used by both CLI and MCP. Returns the created log id or throws.
@@ -11,11 +16,7 @@ export declare const buildAndPushActivityLog: (timeFrame: TimeFrame, cwd: string
 /**
  * Push an activity log for a custom date or date range. timeFrame is used for display (day/week/month).
  */
-export declare const buildAndPushActivityLogWithPeriod: (period: {
-    period_start: string;
-    period_end: string;
-    since: string;
-}, timeFrame: TimeFrame, cwd: string, onProgress?: (step: LogProgressStep) => void) => Promise<{
+export declare const buildAndPushActivityLogWithPeriod: (period: PeriodBounds, timeFrame: TimeFrame, cwd: string, onProgress?: (step: LogProgressStep) => void) => Promise<{
     id: string;
 }>;
 /** Parse argv for log: [start] or [start, end] or [start, '-', end]. Returns { start, end } or null for interactive. */
@@ -28,3 +29,4 @@ export declare class ValidationError extends Error {
     constructor(message: string);
 }
 export declare const runLog: (args?: string[]) => Promise<void>;
+export {};

package/dist/commands/log.js

@@ -1,23 +1,14 @@
+import chalk from 'chalk';
 import inquirer from 'inquirer';
 import ora from 'ora';
-import chalk from 'chalk';
 import { insertActivityLog } from '../api/client.js';
 import { loadCredentials } from '../auth/config.js';
-import { getRepoRoot, getRepoSummary, getGitAnalysis, getPeriodForTimeFrame, getPeriodForCustomDates, parseDate, } from '../lib/git-analysis.js';
-/**
- * Shared logic: resolve repo, compute period, gather summary + git analysis, insert log.
- * Used by both CLI and MCP. Returns the created log id or throws.
- * Optional onProgress callback for CLI to show step-wise spinner (e.g. analyzing → pushing).
- */
-export const buildAndPushActivityLog = async (timeFrame, cwd, onProgress) => {
-    const repoRoot = getRepoRoot(cwd);
-    if (!repoRoot) {
-        throw new Error('Not a git repository. Run from a project with git or pass a valid repo path.');
-    }
-    const period = getPeriodForTimeFrame(timeFrame);
+import { getGitAnalysis, getPeriodForCustomDates, getPeriodForTimeFrame, getRepoRoot, getRepoSummary, parseDate, } from '../lib/git-analysis.js';
+/** Core logic: gather summary + git analysis, insert log. Shared by both build functions. */
+const buildAndPushCore = async (repoRoot, period, timeFrame, onProgress) => {
     onProgress?.('analyzing');
     const repo_summary = getRepoSummary(repoRoot);
-    const git_analysis = getGitAnalysis(repoRoot, period.since);
+    const git_analysis = getGitAnalysis(repoRoot, period.since, period.period_end);
     const payload = {
         time_frame: timeFrame,
         period_start: period.period_start,
@@ -29,6 +20,19 @@ export const buildAndPushActivityLog = async (timeFrame, cwd, onProgress) => {
     const created = await insertActivityLog(payload);
     return { id: created.id };
 };
+/**
+ * Shared logic: resolve repo, compute period, gather summary + git analysis, insert log.
+ * Used by both CLI and MCP. Returns the created log id or throws.
+ * Optional onProgress callback for CLI to show step-wise spinner (e.g. analyzing → pushing).
+ */
+export const buildAndPushActivityLog = async (timeFrame, cwd, onProgress) => {
+    const repoRoot = getRepoRoot(cwd);
+    if (!repoRoot) {
+        throw new Error('Not a git repository. Run from a project with git or pass a valid repo path.');
+    }
+    const period = getPeriodForTimeFrame(timeFrame);
+    return buildAndPushCore(repoRoot, period, timeFrame, onProgress);
+};
 /**
  * Push an activity log for a custom date or date range. timeFrame is used for display (day/week/month).
  */
@@ -37,19 +41,7 @@ export const buildAndPushActivityLogWithPeriod = async (period, timeFrame, cwd,
     if (!repoRoot) {
         throw new Error('Not a git repository. Run from a project with git or pass a valid repo path.');
     }
-    onProgress?.('analyzing');
-    const repo_summary = getRepoSummary(repoRoot);
-    const git_analysis = getGitAnalysis(repoRoot, period.since, period.period_end);
-    const payload = {
-        time_frame: timeFrame,
-        period_start: period.period_start,
-        period_end: period.period_end,
-        repo_summary: repo_summary,
-        git_analysis: git_analysis,
-    };
-    onProgress?.('pushing');
-    const created = await insertActivityLog(payload);
-    return { id: created.id };
+    return buildAndPushCore(repoRoot, period, timeFrame, onProgress);
 };
 const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
 const isDateArg = (s) => ISO_DATE.test(s.trim());
@@ -86,45 +78,28 @@ const timeFrameForRange = (start, end) => {
         return 'week';
     return 'month';
 };
-export const runLog = async (args = []) => {
-    if (!loadCredentials()) {
-        console.error(chalk.red('Not logged in. Run bitcompass login.'));
-        process.exit(1);
+const runLogWithParsedDates = async (parsed, cwd, spinner, onProgress) => {
+    if (!parseDate(parsed.start)) {
+        spinner.stop();
+        throw new ValidationError(`Invalid date "${parsed.start}". Use YYYY-MM-DD (e.g. 2025-02-06).`);
     }
-    const cwd = process.cwd();
-    const repoRoot = getRepoRoot(cwd);
-    if (!repoRoot) {
-        console.error(chalk.red('Not a git repository. Run this command from a project with git.'));
-        process.exit(1);
+    if (parsed.end !== undefined && !parseDate(parsed.end)) {
+        spinner.stop();
+        throw new ValidationError(`Invalid date "${parsed.end}". Use YYYY-MM-DD (e.g. 2025-02-06).`);
     }
-    const parsed = parseLogArgs(args);
-    const spinner = ora('Analyzing repository…').start();
-    const onProgress = (step) => {
-        spinner.text = step === 'analyzing' ? 'Analyzing repository…' : 'Pushing activity log…';
-    };
-    if (parsed) {
-        if (!parseDate(parsed.start)) {
-            spinner.stop();
-            throw new ValidationError(`Invalid date "${parsed.start}". Use YYYY-MM-DD (e.g. 2025-02-06).`);
-        }
-        if (parsed.end !== undefined && !parseDate(parsed.end)) {
-            spinner.stop();
-            throw new ValidationError(`Invalid date "${parsed.end}". Use YYYY-MM-DD (e.g. 2025-02-06).`);
-        }
-        const period = getPeriodForCustomDates(parsed.start, parsed.end);
-        const timeFrame = parsed.end ? timeFrameForRange(parsed.start, parsed.end) : 'day';
-        try {
-            const result = await buildAndPushActivityLogWithPeriod(period, timeFrame, cwd, onProgress);
-            spinner.succeed(chalk.green('Log saved.'));
-            console.log(chalk.dim(result.id));
-        }
-        catch (err) {
-            spinner.fail(chalk.red(err instanceof Error ? err.message : 'Failed'));
-            throw err;
-        }
-        return;
+    const period = getPeriodForCustomDates(parsed.start, parsed.end);
+    const timeFrame = parsed.end ? timeFrameForRange(parsed.start, parsed.end) : 'day';
+    try {
+        const result = await buildAndPushActivityLogWithPeriod(period, timeFrame, cwd, onProgress);
+        spinner.succeed(chalk.green('Log saved.'));
+        console.log(chalk.dim(result.id));
     }
-    spinner.stop();
+    catch (err) {
+        spinner.fail(chalk.red(err instanceof Error ? err.message : 'Failed'));
+        throw err;
+    }
+};
+const runLogInteractive = async (cwd, onProgress) => {
     const choice = await inquirer.prompt([
         {
             name: 'time_frame',
@@ -137,10 +112,9 @@ export const runLog = async (args = []) => {
             ],
         },
     ]);
-    const timeFrame = choice.time_frame;
-    spinner.start('Analyzing repository…');
+    const spinner = ora('Analyzing repository…').start();
     try {
-        const result = await buildAndPushActivityLog(timeFrame, cwd, onProgress);
+        const result = await buildAndPushActivityLog(choice.time_frame, cwd, onProgress);
         spinner.succeed(chalk.green('Log saved.'));
         console.log(chalk.dim(result.id));
     }
@@ -149,3 +123,26 @@ export const runLog = async (args = []) => {
         throw err;
     }
 };
+export const runLog = async (args = []) => {
+    if (!loadCredentials()) {
+        console.error(chalk.red('Not logged in. Run bitcompass login.'));
+        process.exit(1);
+    }
+    const cwd = process.cwd();
+    const repoRoot = getRepoRoot(cwd);
+    if (!repoRoot) {
+        console.error(chalk.red('Not a git repository. Run this command from a project with git.'));
+        process.exit(1);
+    }
+    const parsed = parseLogArgs(args);
+    const spinner = ora('Analyzing repository…').start();
+    const onProgress = (step) => {
+        spinner.text = step === 'analyzing' ? 'Analyzing repository…' : 'Pushing activity log…';
+    };
+    if (parsed) {
+        await runLogWithParsedDates(parsed, cwd, spinner, onProgress);
+        return;
+    }
+    spinner.stop();
+    await runLogInteractive(cwd, onProgress);
+};

package/dist/commands/login.js

@@ -6,6 +6,10 @@ import ora from 'ora';
 import { getTokenFilePath, loadConfig, saveCredentials } from '../auth/config.js';
 import { DEFAULT_SUPABASE_ANON_KEY, DEFAULT_SUPABASE_URL } from '../auth/defaults.js';
 const CALLBACK_PORT = 38473;
+/** Hardcoded Compass rules URL: prod or local testing. Used for "See rules on Compass" link after login. */
+const COMPASS_RULES_URL_PROD = 'https://bitcompass.vercel.app/rules';
+const COMPASS_RULES_URL_DEV = 'http://localhost:8080/rules';
+const getCompassRulesUrl = () => process.env.NODE_ENV === 'development' ? COMPASS_RULES_URL_DEV : COMPASS_RULES_URL_PROD;
 /** Design tokens matching src/index.css (light theme) */
 const STYLES = {
     background: 'hsl(0, 0%, 98%)',
@@ -18,7 +22,25 @@ const STYLES = {
     radius: '0.625rem',
     shadow: '0 10px 15px -3px hsl(220 13% 11% / 0.08), 0 4px 6px -4px hsl(220 13% 11% / 0.05)',
 };
-const CALLBACK_SUCCESS_HTML = `<!DOCTYPE html>
+/**
+ * Builds the Compass rules URL, optionally with auth hash so the web app can set the session
+ * without asking the user to log in again (use-auth.ts reads #access_token and #refresh_token).
+ */
+const compassRulesUrlWithSession = (baseUrl, session) => {
+    if (!session?.access_token || !session?.refresh_token)
+        return baseUrl;
+    const hash = `access_token=${encodeURIComponent(session.access_token)}&refresh_token=${encodeURIComponent(session.refresh_token)}`;
+    return `${baseUrl}#${hash}`;
+};
+/** Builds the post-login success (recap) page HTML with Compass rules CTA link. Session in URL hash persists login on the website. */
+const buildCallbackSuccessHtml = (compassRulesUrl, session) => {
+    const href = compassRulesUrlWithSession(compassRulesUrl, session);
+    const compassCtaBlock = `
+    <div class="compass-cta-block">
+      <a href="${escapeHtml(href)}" class="compass-cta" target="_blank" rel="noopener noreferrer">See Available Rules on Compass</a>
+      <p class="compass-cta-hint">Opens in the same browser; you’ll be signed in automatically.</p>
+    </div>`;
+    return `<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8" />
@@ -119,6 +141,28 @@ const CALLBACK_SUCCESS_HTML = `<!DOCTYPE html>
     }
     .copy-btn:hover { opacity: 0.9; }
     .copy-btn.copied { background: ${STYLES.muted}; cursor: default; }
+    .compass-cta-block {
+      margin-top: 1.25rem;
+      padding-top: 1.25rem;
+      border-top: 1px solid ${STYLES.border};
+    }
+    .compass-cta {
+      display: inline-block;
+      padding: 0.5rem 1rem;
+      background: ${STYLES.primary};
+      color: ${STYLES.primaryForeground};
+      font-size: 0.875rem;
+      font-weight: 600;
+      text-decoration: none;
+      border-radius: 0.5rem;
+      transition: opacity 0.15s;
+    }
+    .compass-cta:hover { opacity: 0.9; }
+    .compass-cta-hint {
+      margin: 0.5rem 0 0;
+      font-size: 0.75rem;
+      color: ${STYLES.muted};
+    }
   </style>
 </head>
 <body>
@@ -131,7 +175,7 @@ const CALLBACK_SUCCESS_HTML = `<!DOCTYPE html>
     </div>
     <h1>You're all set</h1>
     <p class="muted">You're logged in successfully. You can close this window safely—your credentials are saved and the CLI is ready to use.</p>
-    <p class="hint">Return to your terminal to continue.</p>
+    <p class="hint">Return to your terminal to continue.</p>${compassCtaBlock}
     <div class="verify-block">
       <p class="muted" style="margin:0">Verify in terminal:</p>
       <div class="cmd-row">
@@ -159,6 +203,7 @@ const CALLBACK_SUCCESS_HTML = `<!DOCTYPE html>
   </script>
 </body>
 </html>`;
+};
 const escapeHtml = (s) => s
     .replace(/&/g, '&amp;')
     .replace(/</g, '&lt;')
@@ -301,7 +346,7 @@ export const runLogin = async () => {
                     const tokenPath = getTokenFilePath();
                     saveCredentials(creds);
                     res.writeHead(200, { 'Content-Type': 'text/html' });
-                    res.end(CALLBACK_SUCCESS_HTML);
+                    res.end(buildCallbackSuccessHtml(getCompassRulesUrl(), session));
                     spinner.succeed(chalk.green('Logged in successfully.'));
                     console.log(chalk.dim('Credentials saved to:'), tokenPath);
                     server.close();

package/dist/commands/rules.d.ts

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

package/dist/commands/rules.js

@@ -2,10 +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 { parseRuleMdcContent } from '../lib/mdc-format.js';
 import { formatList, shouldUseTable } from '../lib/list-format.js';
+import { runSharePush } from './share.js';
 export const runRulesSearch = async (query, options) => {
     if (!loadCredentials()) {
         console.error(chalk.red('Not logged in. Run bitcompass login.'));
@@ -96,48 +96,6 @@ export const runRulesPull = async (id, options) => {
         process.exit(message.includes('not found') ? 2 : 1);
     }
 };
-export const runRulesPush = 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);
-        }
-        catch {
-            const parsed = parseRuleMdcContent(raw);
-            if (parsed) {
-                const titleFromBody = parsed.body.split('\n')[0]?.replace(/^#\s*/, '').trim() || 'Untitled';
-                payload = {
-                    kind: 'rule',
-                    title: titleFromBody,
-                    description: parsed.description,
-                    body: parsed.body,
-                    globs: parsed.globs ?? undefined,
-                    always_apply: parsed.alwaysApply,
-                };
-            }
-            else {
-                const lines = raw.split('\n');
-                const title = lines[0].replace(/^#\s*/, '') || 'Untitled';
-                payload = { kind: 'rule', title, description: '', body: raw };
-            }
-        }
-    }
-    else {
-        const answers = await inquirer.prompt([
-            { name: 'title', message: 'Rule title', type: 'input', default: 'Untitled' },
-            { name: 'description', message: 'Description', type: 'input', default: '' },
-            { name: 'body', message: 'Rule content', type: 'editor', default: '' },
-        ]);
-        payload = { kind: 'rule', title: answers.title, description: answers.description, body: answers.body };
-    }
-    const spinner = ora('Publishing rule…').start();
-    const created = await insertRule(payload);
-    spinner.succeed(chalk.green('Published rule ') + created.id);
-    console.log(chalk.dim(created.title));
+export const runRulesPush = async (file, options) => {
+    await runSharePush(file, { kind: 'rule', projectId: options?.projectId });
 };

package/dist/commands/share.d.ts

@@ -0,0 +1,19 @@
+import type { RuleInsert, RuleKind } from '../types.js';
+/**
+ * Infers RuleKind from file content (frontmatter kind) or filename prefix.
+ */
+export declare const inferKindFromFile: (filePath: string, rawContent: string) => RuleKind | null;
+/**
+ * Parses file content into RuleInsert. Uses explicitKind if provided, else inferred from file.
+ * If kind cannot be determined, payload.kind may be left undefined (caller should prompt).
+ */
+export declare const parseFileToPayload: (filePath: string, rawContent: string, explicitKind?: RuleKind) => Omit<RuleInsert, "kind"> & {
+    kind?: RuleKind;
+};
+/**
+ * Unified share push: optionally read from file, infer or prompt for kind, then publish.
+ */
+export declare const runSharePush: (file?: string, options?: {
+    kind?: RuleKind;
+    projectId?: string;
+}) => Promise<void>;

package/dist/commands/share.js

@@ -0,0 +1,137 @@
+import { readFileSync } from 'fs';
+import inquirer from 'inquirer';
+import ora from 'ora';
+import chalk from 'chalk';
+import { loadCredentials } from '../auth/config.js';
+import { insertRule } from '../api/client.js';
+import { parseRuleMdcContent, parseFrontmatterKind } from '../lib/mdc-format.js';
+import { SHARE_KIND_CHOICES, inferKindFromFilename } from '../lib/share-types.js';
+const KIND_LABELS = {
+    rule: 'rule',
+    solution: 'solution',
+    skill: 'skill',
+    command: 'command',
+};
+/**
+ * Infers RuleKind from file content (frontmatter kind) or filename prefix.
+ */
+export const inferKindFromFile = (filePath, rawContent) => {
+    const fromFrontmatter = parseFrontmatterKind(rawContent);
+    if (fromFrontmatter)
+        return fromFrontmatter;
+    return inferKindFromFilename(filePath);
+};
+/**
+ * Parses file content into RuleInsert. Uses explicitKind if provided, else inferred from file.
+ * If kind cannot be determined, payload.kind may be left undefined (caller should prompt).
+ */
+export const parseFileToPayload = (filePath, rawContent, explicitKind) => {
+    const inferredKind = inferKindFromFile(filePath, rawContent);
+    const kind = explicitKind ?? inferredKind ?? undefined;
+    try {
+        const parsed = JSON.parse(rawContent);
+        const payload = {
+            kind: parsed.kind ?? kind ?? 'rule',
+            title: parsed.title ?? 'Untitled',
+            description: parsed.description ?? '',
+            body: parsed.body ?? '',
+            context: typeof parsed.context === 'string' ? parsed.context : undefined,
+            examples: Array.isArray(parsed.examples) ? parsed.examples : undefined,
+            technologies: Array.isArray(parsed.technologies) ? parsed.technologies : undefined,
+            globs: typeof parsed.globs === 'string' ? parsed.globs : undefined,
+            always_apply: Boolean(parsed.always_apply),
+        };
+        if (explicitKind)
+            payload.kind = explicitKind;
+        else if (kind)
+            payload.kind = kind;
+        return payload;
+    }
+    catch {
+        // not JSON
+    }
+    const mdc = parseRuleMdcContent(rawContent);
+    if (mdc) {
+        const titleFromBody = mdc.body.split('\n')[0]?.replace(/^#\s*/, '').trim() || 'Untitled';
+        return {
+            kind: explicitKind ?? mdc.kind ?? inferredKind ?? undefined,
+            title: titleFromBody,
+            description: mdc.description,
+            body: mdc.body,
+            globs: mdc.globs ?? undefined,
+            always_apply: mdc.alwaysApply,
+        };
+    }
+    const lines = rawContent.split('\n');
+    const title = (lines[0] ?? '').replace(/^#\s*/, '').trim() || 'Untitled';
+    return {
+        kind: explicitKind ?? inferredKind ?? undefined,
+        title,
+        description: '',
+        body: rawContent,
+    };
+};
+const promptForKind = async () => {
+    const { kind } = await inquirer.prompt([
+        {
+            name: 'kind',
+            message: 'What are you sharing?',
+            type: 'list',
+            choices: SHARE_KIND_CHOICES.map((c) => ({ name: `${c.name} – ${c.description}`, value: c.value })),
+        },
+    ]);
+    return kind;
+};
+/**
+ * Unified share push: optionally read from file, infer or prompt for kind, then publish.
+ */
+export const runSharePush = async (file, options) => {
+    if (!loadCredentials()) {
+        console.error(chalk.red('Not logged in. Run bitcompass login.'));
+        process.exit(1);
+    }
+    let payload;
+    if (file) {
+        const raw = readFileSync(file, 'utf-8');
+        const parsed = parseFileToPayload(file, raw, options?.kind);
+        let kind = parsed.kind;
+        if (!kind) {
+            kind = await promptForKind();
+        }
+        payload = {
+            kind,
+            title: parsed.title,
+            description: parsed.description ?? '',
+            body: parsed.body,
+            context: parsed.context,
+            examples: parsed.examples,
+            technologies: parsed.technologies,
+            project_id: options?.projectId,
+            globs: parsed.globs,
+            always_apply: parsed.always_apply,
+        };
+    }
+    else {
+        const kind = options?.kind ?? (await promptForKind());
+        const answers = await inquirer.prompt([
+            { name: 'title', message: 'Title', type: 'input', default: 'Untitled' },
+            { name: 'description', message: 'Description', type: 'input', default: '' },
+            { name: 'body', message: 'Content', type: 'editor', default: '' },
+        ]);
+        payload = {
+            kind,
+            title: answers.title,
+            description: answers.description,
+            body: answers.body,
+            project_id: options?.projectId,
+        };
+    }
+    if (options?.projectId) {
+        payload = { ...payload, project_id: options.projectId };
+    }
+    const label = KIND_LABELS[payload.kind];
+    const spinner = ora(`Publishing ${label}…`).start();
+    const created = await insertRule(payload);
+    spinner.succeed(chalk.green(`Published ${label} `) + created.id);
+    console.log(chalk.dim(created.title));
+};

package/dist/commands/skills.d.ts

@@ -8,4 +8,6 @@ export declare const runSkillsPull: (id?: string, options?: {
     global?: boolean;
     copy?: boolean;
 }) => Promise<void>;
-export declare const runSkillsPush: (file?: string) => Promise<void>;
+export declare const runSkillsPush: (file?: string, options?: {
+    projectId?: string;
+}) => Promise<void>;

package/dist/commands/skills.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 runSkillsSearch = async (query, options) => {
     if (!loadCredentials()) {
         console.error(chalk.red('Not logged in. Run bitcompass login.'));
@@ -95,35 +96,6 @@ export const runSkillsPull = async (id, options) => {
         process.exit(message.includes('not found') ? 2 : 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));
+export const runSkillsPush = async (file, options) => {
+    await runSharePush(file, { kind: 'skill', projectId: options?.projectId });
 };

package/dist/commands/solutions.d.ts

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

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/index.js

@@ -16,6 +16,7 @@ import { runSolutionsList, runSolutionsPull, runSolutionsPush, runSolutionsSearc
 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 { runSharePush } from './commands/share.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/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.8",
+  "version": "0.4.0",
   "description": "BitCompass CLI - rules, solutions, and MCP server",
   "type": "module",
   "bin": {

package/scripts/postinstall.js

@@ -99,9 +99,7 @@ const animateAuthorLine = async () => {
   process.stdout.write("\r\x1b[K" + finalLine + "\n");
 };
 
-(async () => {
-  console.log("");
-  console.log(gradient(`version ${version}`, cyan, magenta));
-  await animateAuthorLine();
-  console.log("");
-})();
+console.log("");
+console.log(gradient(`version ${version}`, cyan, magenta));
+await animateAuthorLine();
+console.log("");