@antistud/handrails-cli 0.1.0

package/dist/bin/handrails-rig.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Standalone rig entrypoint.
+ *
+ * Usage:
+ *   npx @handrails/cli rig --rig-key rig_xxx
+ *   npx @handrails/cli rig --rig-key rig_xxx --api-url http://localhost:3030
+ */
+export {};

package/dist/bin/handrails-rig.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Standalone rig entrypoint.
+ *
+ * Usage:
+ *   npx @handrails/cli rig --rig-key rig_xxx
+ *   npx @handrails/cli rig --rig-key rig_xxx --api-url http://localhost:3030
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("../src/cli");
+// Inject 'rig' as the command so the user doesn't have to type it
+const args = [...process.argv.slice(0, 2), 'rig', ...process.argv.slice(2)];
+const program = (0, cli_1.createProgram)();
+program.parseAsync(args).catch((err) => {
+    console.error(err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=handrails-rig.js.map

package/dist/bin/handrails-rig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handrails-rig.js","sourceRoot":"","sources":["../../bin/handrails-rig.ts"],"names":[],"mappings":";;AAEA;;;;;;GAMG;;AAEH,oCAA2C;AAE3C,kEAAkE;AAClE,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5E,MAAM,OAAO,GAAG,IAAA,mBAAa,GAAE,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACrC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/bin/handrails.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/handrails.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("../src/cli");
+const program = (0, cli_1.createProgram)();
+program.parseAsync(process.argv).catch((err) => {
+    console.error(err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=handrails.js.map

package/dist/bin/handrails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handrails.js","sourceRoot":"","sources":["../../bin/handrails.ts"],"names":[],"mappings":";;;AAEA,oCAA2C;AAE3C,MAAM,OAAO,GAAG,IAAA,mBAAa,GAAE,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC7C,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/bridge/daemon.d.ts

@@ -0,0 +1,50 @@
+import { HandrailsClient } from '../handrails/client';
+export interface BridgeMessage {
+    jsonrpc: '2.0';
+    id?: string;
+    method?: string;
+    params?: any;
+    result?: any;
+    error?: {
+        code: number;
+        message: string;
+        data?: any;
+    };
+}
+export type ToolHandler = (params: any) => Promise<any>;
+export declare class BridgeDaemon {
+    private ws;
+    private apiUrl;
+    private apiKey;
+    private machineName;
+    private connectionId;
+    private reconnectAttempts;
+    private maxReconnectAttempts;
+    private reconnectTimer;
+    private heartbeatTimer;
+    private isShuttingDown;
+    private toolHandlers;
+    private pendingResponses;
+    private client;
+    private activeEngines;
+    constructor(apiUrl?: string, apiKey?: string);
+    private registerBuiltinTools;
+    registerTool(method: string, handler: ToolHandler): void;
+    start(): Promise<void>;
+    private connect;
+    private handleMessage;
+    private send;
+    private sendResponse;
+    sendNotification(method: string, params?: any): void;
+    /**
+     * Send a request to the server and wait for a response.
+     * Used for workflow decision nodes that need user input from the web UI.
+     */
+    sendRequestAndWait(method: string, params?: any, timeoutMs?: number): Promise<any>;
+    getClient(): HandrailsClient;
+    getConnectionId(): string | null;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private scheduleReconnect;
+    private shutdown;
+}

package/dist/src/bridge/daemon.js

@@ -0,0 +1,319 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BridgeDaemon = void 0;
+const ws_1 = __importDefault(require("ws"));
+const os = __importStar(require("os"));
+const config_1 = require("../config");
+const client_1 = require("../handrails/client");
+const engine_1 = require("../workflow/engine");
+class BridgeDaemon {
+    constructor(apiUrl, apiKey) {
+        this.ws = null;
+        this.connectionId = null;
+        this.reconnectAttempts = 0;
+        this.maxReconnectAttempts = 50;
+        this.reconnectTimer = null;
+        this.heartbeatTimer = null;
+        this.isShuttingDown = false;
+        this.toolHandlers = new Map();
+        this.pendingResponses = new Map();
+        this.activeEngines = new Map();
+        const config = (0, config_1.loadConfig)();
+        this.apiUrl = apiUrl || config.apiUrl;
+        this.apiKey = apiKey || config.apiKey;
+        this.machineName = os.hostname();
+        this.client = new client_1.HandrailsClient(this.apiUrl, this.apiKey);
+        // Register built-in tool handlers
+        this.registerBuiltinTools();
+    }
+    registerBuiltinTools() {
+        // Ping/pong for health checks
+        this.registerTool('ping', async () => ({ pong: true, timestamp: new Date().toISOString() }));
+        // Read file from local filesystem
+        this.registerTool('file.read', async (params) => {
+            const fs = require('fs');
+            const content = fs.readFileSync(params.path, 'utf-8');
+            return { content, path: params.path };
+        });
+        // List directory contents
+        this.registerTool('file.list', async (params) => {
+            const fs = require('fs');
+            const entries = fs.readdirSync(params.path, { withFileTypes: true });
+            return {
+                entries: entries.map((e) => ({
+                    name: e.name,
+                    type: e.isDirectory() ? 'directory' : 'file',
+                })),
+                path: params.path,
+            };
+        });
+        // Search files with grep-like pattern
+        this.registerTool('file.search', async (params) => {
+            const { execSync } = require('child_process');
+            try {
+                const result = execSync(`grep -rn "${params.pattern.replace(/"/g, '\\"')}" "${params.path}" --include="*.ts" --include="*.js" --include="*.tsx" --include="*.jsx" --include="*.py" --include="*.go" --include="*.rs" -l`, { encoding: 'utf-8', maxBuffer: 1024 * 1024 });
+                return { files: result.trim().split('\n').filter(Boolean) };
+            }
+            catch {
+                return { files: [] };
+            }
+        });
+        // Run a shell command
+        this.registerTool('shell.exec', async (params) => {
+            const { execSync } = require('child_process');
+            try {
+                const stdout = execSync(params.command, {
+                    encoding: 'utf-8',
+                    cwd: params.cwd || process.cwd(),
+                    maxBuffer: 5 * 1024 * 1024,
+                    timeout: 30000,
+                });
+                return { stdout, exitCode: 0 };
+            }
+            catch (error) {
+                return {
+                    stdout: error.stdout || '',
+                    stderr: error.stderr || '',
+                    exitCode: error.status || 1,
+                };
+            }
+        });
+        // Git status
+        this.registerTool('git.status', async (params) => {
+            const { execSync } = require('child_process');
+            const cwd = params?.cwd || process.cwd();
+            const status = execSync('git status --porcelain', { encoding: 'utf-8', cwd });
+            const branch = execSync('git branch --show-current', { encoding: 'utf-8', cwd }).trim();
+            return { branch, files: status.trim().split('\n').filter(Boolean) };
+        });
+        // Workflow: start execution
+        this.registerTool('workflow.start', async (params) => {
+            const engine = new engine_1.WorkflowEngine(this, this.client);
+            this.activeEngines.set(params.run_id, engine);
+            // Execute asynchronously - progress is streamed via notifications
+            engine.execute(params.workflow, params.run_id, params.input)
+                .finally(() => this.activeEngines.delete(params.run_id));
+            return { accepted: true, run_id: params.run_id };
+        });
+    }
+    registerTool(method, handler) {
+        this.toolHandlers.set(method, handler);
+    }
+    async start() {
+        if (!this.apiKey) {
+            throw new Error('Not authenticated. Run "handrails login" first.');
+        }
+        console.log(`Connecting to Handrails bridge at ${this.apiUrl}...`);
+        this.connect();
+        // Handle graceful shutdown
+        process.on('SIGINT', () => this.shutdown());
+        process.on('SIGTERM', () => this.shutdown());
+        // Keep process alive
+        return new Promise(() => { });
+    }
+    connect() {
+        if (this.isShuttingDown)
+            return;
+        const wsUrl = this.apiUrl
+            .replace('https://', 'wss://')
+            .replace('http://', 'ws://');
+        const url = `${wsUrl}/bridge-ws?api_key=${encodeURIComponent(this.apiKey)}&machine=${encodeURIComponent(this.machineName)}`;
+        this.ws = new ws_1.default(url);
+        this.ws.on('open', () => {
+            this.reconnectAttempts = 0;
+            console.log('Connected to Handrails bridge');
+            this.startHeartbeat();
+        });
+        this.ws.on('message', (data) => {
+            try {
+                const message = JSON.parse(data.toString());
+                this.handleMessage(message);
+            }
+            catch (error) {
+                console.error('Error parsing message:', error);
+            }
+        });
+        this.ws.on('close', (code, reason) => {
+            console.log(`Bridge connection closed: ${code} ${reason}`);
+            this.stopHeartbeat();
+            this.connectionId = null;
+            this.scheduleReconnect();
+        });
+        this.ws.on('error', (error) => {
+            console.error('Bridge connection error:', error.message);
+        });
+    }
+    async handleMessage(message) {
+        // Handle welcome message
+        if (message.method === 'bridge.connected') {
+            this.connectionId = message.params?.connectionId;
+            console.log(`Bridge established. Connection ID: ${this.connectionId}`);
+            return;
+        }
+        // Handle ping from server
+        if (message.method === 'ping') {
+            this.send({ jsonrpc: '2.0', method: 'heartbeat' });
+            return;
+        }
+        // Handle workflow user response (notification from server when user answers a decision prompt)
+        if (message.method === 'workflow.user_response' && message.params) {
+            const { run_id, node_id, response } = message.params;
+            const engine = this.activeEngines.get(run_id);
+            if (engine) {
+                engine.handleUserResponse(run_id, node_id, response);
+            }
+            return;
+        }
+        // Handle response to our requests (for workflow user responses, etc.)
+        if (message.id && !message.method) {
+            const pending = this.pendingResponses.get(message.id);
+            if (pending) {
+                this.pendingResponses.delete(message.id);
+                if (message.error) {
+                    pending.reject(message.error);
+                }
+                else {
+                    pending.resolve(message.result);
+                }
+            }
+            return;
+        }
+        // Handle incoming request (tool execution, workflow start, etc.)
+        if (message.id && message.method) {
+            const handler = this.toolHandlers.get(message.method);
+            if (!handler) {
+                this.sendResponse(message.id, undefined, {
+                    code: -32601,
+                    message: `Method not found: ${message.method}`,
+                });
+                return;
+            }
+            try {
+                const result = await handler(message.params);
+                this.sendResponse(message.id, result);
+            }
+            catch (error) {
+                this.sendResponse(message.id, undefined, {
+                    code: -32000,
+                    message: error.message || 'Tool execution failed',
+                });
+            }
+            return;
+        }
+    }
+    send(message) {
+        if (this.ws && this.ws.readyState === ws_1.default.OPEN) {
+            this.ws.send(JSON.stringify(message));
+        }
+    }
+    sendResponse(id, result, error) {
+        const response = { jsonrpc: '2.0', id };
+        if (error) {
+            response.error = error;
+        }
+        else {
+            response.result = result;
+        }
+        this.send(response);
+    }
+    sendNotification(method, params) {
+        this.send({ jsonrpc: '2.0', method, params });
+    }
+    /**
+     * Send a request to the server and wait for a response.
+     * Used for workflow decision nodes that need user input from the web UI.
+     */
+    async sendRequestAndWait(method, params, timeoutMs = 300000) {
+        const id = Math.random().toString(36).substring(2, 10);
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pendingResponses.delete(id);
+                reject(new Error(`Request timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.pendingResponses.set(id, {
+                resolve: (value) => { clearTimeout(timer); resolve(value); },
+                reject: (error) => { clearTimeout(timer); reject(error); },
+            });
+            this.send({ jsonrpc: '2.0', id, method, params });
+        });
+    }
+    getClient() {
+        return this.client;
+    }
+    getConnectionId() {
+        return this.connectionId;
+    }
+    startHeartbeat() {
+        this.heartbeatTimer = setInterval(() => {
+            this.send({ jsonrpc: '2.0', method: 'heartbeat' });
+        }, 25000);
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+    scheduleReconnect() {
+        if (this.isShuttingDown)
+            return;
+        if (this.reconnectAttempts >= this.maxReconnectAttempts) {
+            console.error('Max reconnect attempts reached. Exiting.');
+            process.exit(1);
+        }
+        const delay = Math.min(1000 * Math.pow(2, this.reconnectAttempts), 30000);
+        this.reconnectAttempts++;
+        console.log(`Reconnecting in ${delay / 1000}s (attempt ${this.reconnectAttempts})...`);
+        this.reconnectTimer = setTimeout(() => {
+            this.connect();
+        }, delay);
+    }
+    shutdown() {
+        console.log('\nShutting down bridge daemon...');
+        this.isShuttingDown = true;
+        this.stopHeartbeat();
+        if (this.reconnectTimer)
+            clearTimeout(this.reconnectTimer);
+        if (this.ws)
+            this.ws.close(1000, 'Client shutting down');
+        process.exit(0);
+    }
+}
+exports.BridgeDaemon = BridgeDaemon;
+//# sourceMappingURL=daemon.js.map

package/dist/src/bridge/daemon.js.map

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

package/dist/src/claude/context-manager.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Get the current CLAUDE.md content for a project, separated into
+ * team-managed and local sections.
+ */
+export declare function getContextSections(projectPath: string): {
+    full: string | null;
+    teamSection: string | null;
+    localSection: string | null;
+};
+/**
+ * Pull team CLAUDE.md template from Handrails and merge with local content.
+ */
+export declare function pullContext(projectPath: string): Promise<{
+    updated: boolean;
+    templateFound: boolean;
+    path: string;
+}>;
+/**
+ * Push the local (non-team) section of CLAUDE.md to Handrails as a template suggestion.
+ */
+export declare function pushContext(projectPath: string): Promise<{
+    pushed: boolean;
+    content: string | null;
+}>;
+/**
+ * Sync slash commands between local and team.
+ * Pull: team commands -> local slash-commands dir
+ * Push: local-only commands -> stored as knowledge in Handrails
+ */
+export declare function syncSlashCommands(direction?: 'pull' | 'push' | 'both'): Promise<{
+    pulled: number;
+    pushed: number;
+    commands: string[];
+}>;
+/**
+ * Suggest an update to CLAUDE.md — returns the proposed content without writing.
+ */
+export declare function suggestContextUpdate(projectPath: string, addition: string, section?: 'local' | 'team'): {
+    currentContent: string | null;
+    proposedContent: string;
+};

package/dist/src/claude/context-manager.js

@@ -0,0 +1,184 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getContextSections = getContextSections;
+exports.pullContext = pullContext;
+exports.pushContext = pushContext;
+exports.syncSlashCommands = syncSlashCommands;
+exports.suggestContextUpdate = suggestContextUpdate;
+const path = __importStar(require("path"));
+const client_1 = require("../handrails/client");
+const config_1 = require("../config");
+const reader_1 = require("./reader");
+const TEAM_SECTION_START = '<!-- handrails:team-context:start -->';
+const TEAM_SECTION_END = '<!-- handrails:team-context:end -->';
+/**
+ * Get the current CLAUDE.md content for a project, separated into
+ * team-managed and local sections.
+ */
+function getContextSections(projectPath) {
+    const content = (0, reader_1.getProjectClaudeMd)(projectPath);
+    if (!content)
+        return { full: null, teamSection: null, localSection: null };
+    const startIdx = content.indexOf(TEAM_SECTION_START);
+    const endIdx = content.indexOf(TEAM_SECTION_END);
+    if (startIdx === -1 || endIdx === -1) {
+        return { full: content, teamSection: null, localSection: content };
+    }
+    const teamSection = content.substring(startIdx + TEAM_SECTION_START.length, endIdx).trim();
+    const beforeTeam = content.substring(0, startIdx).trim();
+    const afterTeam = content.substring(endIdx + TEAM_SECTION_END.length).trim();
+    const localSection = [beforeTeam, afterTeam].filter(Boolean).join('\n\n');
+    return { full: content, teamSection, localSection };
+}
+/**
+ * Pull team CLAUDE.md template from Handrails and merge with local content.
+ */
+async function pullContext(projectPath) {
+    const config = (0, config_1.loadConfig)();
+    const projectConfig = config.projects[projectPath];
+    const projectTag = projectConfig?.projectTag || path.basename(projectPath);
+    const client = new client_1.HandrailsClient();
+    const template = await client.getClaudeMdTemplate(projectTag);
+    const claudeMdPath = path.join(projectPath, 'CLAUDE.md');
+    if (!template) {
+        return { updated: false, templateFound: false, path: claudeMdPath };
+    }
+    const existing = (0, reader_1.getProjectClaudeMd)(projectPath);
+    if (!existing) {
+        // No local CLAUDE.md — write the team template with markers
+        const content = `${TEAM_SECTION_START}\n${template}\n${TEAM_SECTION_END}\n`;
+        (0, reader_1.writeProjectClaudeMd)(projectPath, content);
+        return { updated: true, templateFound: true, path: claudeMdPath };
+    }
+    // Merge: replace team section, preserve local content
+    const { localSection } = getContextSections(projectPath);
+    const parts = [];
+    if (localSection) {
+        parts.push(localSection);
+        parts.push('');
+    }
+    parts.push(TEAM_SECTION_START);
+    parts.push(template);
+    parts.push(TEAM_SECTION_END);
+    (0, reader_1.writeProjectClaudeMd)(projectPath, parts.join('\n'));
+    return { updated: true, templateFound: true, path: claudeMdPath };
+}
+/**
+ * Push the local (non-team) section of CLAUDE.md to Handrails as a template suggestion.
+ */
+async function pushContext(projectPath) {
+    const { localSection } = getContextSections(projectPath);
+    if (!localSection) {
+        return { pushed: false, content: null };
+    }
+    const config = (0, config_1.loadConfig)();
+    const projectConfig = config.projects[projectPath];
+    const projectTag = projectConfig?.projectTag || path.basename(projectPath);
+    const client = new client_1.HandrailsClient();
+    await client.saveClaudeMdTemplate(localSection, projectTag);
+    return { pushed: true, content: localSection };
+}
+/**
+ * Sync slash commands between local and team.
+ * Pull: team commands -> local slash-commands dir
+ * Push: local-only commands -> stored as knowledge in Handrails
+ */
+async function syncSlashCommands(direction = 'both') {
+    const client = new client_1.HandrailsClient();
+    let pulled = 0;
+    let pushed = 0;
+    const commands = [];
+    if (direction === 'pull' || direction === 'both') {
+        const teamCommands = await client.listCommands();
+        for (const cmd of teamCommands) {
+            if (!cmd.is_active)
+                continue;
+            const content = cmd.description
+                ? `${cmd.description}\n\n${cmd.system_prompt}`
+                : cmd.system_prompt;
+            (0, reader_1.writeSlashCommand)(cmd.name, content);
+            commands.push(`pull: /${cmd.name}`);
+            pulled++;
+        }
+    }
+    if (direction === 'push' || direction === 'both') {
+        const localCommands = (0, reader_1.getSlashCommands)();
+        const teamCommands = direction === 'both'
+            ? await client.listCommands()
+            : await client.listCommands();
+        const teamNames = new Set(teamCommands.map(c => c.name));
+        for (const local of localCommands) {
+            if (teamNames.has(local.name))
+                continue; // Already exists on team
+            // Store local command as knowledge for now
+            // (full command sync would need a POST /mcp/commands endpoint)
+            await client.storeDocument(`Slash Command: /${local.name}`, `# /${local.name}\n\n${local.content}`);
+            commands.push(`push: /${local.name}`);
+            pushed++;
+        }
+    }
+    return { pulled, pushed, commands };
+}
+/**
+ * Suggest an update to CLAUDE.md — returns the proposed content without writing.
+ */
+function suggestContextUpdate(projectPath, addition, section = 'local') {
+    const current = (0, reader_1.getProjectClaudeMd)(projectPath);
+    if (!current) {
+        return {
+            currentContent: null,
+            proposedContent: `${addition}\n`,
+        };
+    }
+    if (section === 'team') {
+        const startIdx = current.indexOf(TEAM_SECTION_START);
+        const endIdx = current.indexOf(TEAM_SECTION_END);
+        if (startIdx !== -1 && endIdx !== -1) {
+            const teamContent = current.substring(startIdx + TEAM_SECTION_START.length, endIdx).trim();
+            const newTeamContent = `${teamContent}\n\n${addition}`;
+            const proposed = current.substring(0, startIdx + TEAM_SECTION_START.length) +
+                '\n' + newTeamContent + '\n' +
+                current.substring(endIdx);
+            return { currentContent: current, proposedContent: proposed };
+        }
+    }
+    // Append to end (local section)
+    return {
+        currentContent: current,
+        proposedContent: `${current}\n\n${addition}\n`,
+    };
+}
+//# sourceMappingURL=context-manager.js.map