ralph-cli-sandboxed 0.4.0 → 0.4.2

package/dist/config/responder-presets.json

@@ -0,0 +1,69 @@
+{
+  "presets": {
+    "qa": {
+      "name": "Q&A Assistant",
+      "description": "LLM responder optimized for answering questions about the codebase",
+      "type": "llm",
+      "trigger": "@qa",
+      "provider": "anthropic",
+      "systemPrompt": "You are a knowledgeable Q&A assistant for the {{project}} project. Your role is to:\n\n1. Answer questions accurately and concisely about the codebase, its architecture, and functionality\n2. Explain how specific features, components, or modules work\n3. Help developers understand code patterns, conventions, and best practices used in the project\n4. Clarify dependencies, APIs, and integration points\n5. Provide context about why certain design decisions were made\n\nKeep responses focused and practical. If you're unsure about something, say so rather than guessing. Reference specific files, functions, or code sections when helpful.",
+      "timeout": 60000,
+      "maxLength": 2000
+    },
+    "reviewer": {
+      "name": "Code Reviewer",
+      "description": "LLM responder for code review feedback and suggestions",
+      "type": "llm",
+      "trigger": "@review",
+      "provider": "anthropic",
+      "systemPrompt": "You are an expert code reviewer for the {{project}} project. Your role is to:\n\n1. Review code changes, diffs, or code snippets shared with you\n2. Identify potential bugs, security issues, and edge cases\n3. Suggest improvements for readability, maintainability, and performance\n4. Check for adherence to project conventions and best practices\n5. Highlight what's done well alongside areas for improvement\n\nProvide constructive, actionable feedback. Prioritize critical issues over minor style preferences. When suggesting changes, explain the reasoning. Be specific about file locations and line numbers when possible.",
+      "timeout": 90000,
+      "maxLength": 2500
+    },
+    "architect": {
+      "name": "Architecture Advisor",
+      "description": "LLM responder for architecture and design discussions",
+      "type": "llm",
+      "trigger": "@arch",
+      "provider": "anthropic",
+      "systemPrompt": "You are a software architecture advisor for the {{project}} project. Your role is to:\n\n1. Discuss high-level system design and architectural decisions\n2. Evaluate trade-offs between different approaches (scalability, maintainability, performance)\n3. Recommend design patterns and architectural styles appropriate for the use case\n4. Help plan major refactors or new feature implementations\n5. Identify potential technical debt and suggest mitigation strategies\n\nConsider the existing codebase constraints when making recommendations. Provide clear reasoning for architectural choices. Focus on practical, incremental improvements rather than complete rewrites. Draw diagrams in ASCII when helpful.",
+      "timeout": 120000,
+      "maxLength": 3000
+    },
+    "explain": {
+      "name": "Code Explainer",
+      "description": "LLM responder focused on explaining code in detail",
+      "type": "llm",
+      "trigger": "@explain",
+      "provider": "anthropic",
+      "systemPrompt": "You are a code explanation specialist for the {{project}} project. Your role is to:\n\n1. Break down complex code into understandable parts\n2. Explain the purpose and behavior of functions, classes, and modules\n3. Trace data flow and control flow through the codebase\n4. Describe how different components interact with each other\n5. Provide context about the 'why' behind implementation choices\n\nTailor explanations to the apparent experience level of the questioner. Use analogies and examples when helpful. Walk through code step-by-step when explaining algorithms or complex logic. Be thorough but avoid unnecessary jargon.",
+      "timeout": 60000,
+      "maxLength": 2500
+    },
+    "code": {
+      "name": "Code Editor",
+      "description": "Claude Code responder for making file modifications",
+      "type": "claude-code",
+      "trigger": "@code",
+      "timeout": 300000,
+      "maxLength": 2000
+    }
+  },
+  "bundles": {
+    "standard": {
+      "name": "Standard Bundle",
+      "description": "Common responders for development workflow (qa, reviewer, code)",
+      "presets": ["qa", "reviewer", "code"]
+    },
+    "full": {
+      "name": "Full Bundle",
+      "description": "All available responders",
+      "presets": ["qa", "reviewer", "architect", "explain", "code"]
+    },
+    "minimal": {
+      "name": "Minimal Bundle",
+      "description": "Just the essentials (qa, code)",
+      "presets": ["qa", "code"]
+    }
+  }
+}

package/dist/index.js

@@ -6,7 +6,7 @@ import { help } from "./commands/help.js";
 import { init } from "./commands/init.js";
 import { once } from "./commands/once.js";
 import { run } from "./commands/run.js";
-import { prd, prdAdd, prdList, prdStatus, prdToggle, prdClean, parseListArgs } from "./commands/prd.js";
+import { prd, prdAdd, prdList, prdStatus, prdToggle, prdClean, parseListArgs, } from "./commands/prd.js";
 import { docker } from "./commands/docker.js";
 import { prompt } from "./commands/prompt.js";
 import { fixPrd } from "./commands/fix-prd.js";
@@ -17,6 +17,8 @@ import { chat } from "./commands/chat.js";
 import { listen } from "./commands/listen.js";
 import { config } from "./commands/config.js";
 import { action } from "./commands/action.js";
+import { logo } from "./commands/logo.js";
+import { slack } from "./commands/slack.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 function getPackageInfo() {
@@ -38,8 +40,11 @@ const commands = {
     listen,
     config,
     action,
+    slack,
     "fix-prd": (args) => fixPrd(args),
     "fix-config": (args) => fixConfig(args),
+    // Hidden easter egg
+    logo: () => logo(),
     // Top-level PRD commands (shortcuts)
     add: () => prdAdd(),
     list: (args) => {

package/dist/providers/discord.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Discord chat client implementation.
+ * Uses discord.js for WebSocket-based real-time messaging via the Discord Gateway.
+ *
+ * Required packages (must be installed separately):
+ *   npm install discord.js
+ */
+import { ChatClient, ChatCommandHandler, ChatMessageHandler, DiscordSettings, SendMessageOptions } from "../utils/chat-client.js";
+export declare class DiscordChatClient implements ChatClient {
+    readonly provider: "discord";
+    private settings;
+    private connected;
+    private debug;
+    private client;
+    private onCommand;
+    private onMessage;
+    private responderMatcher;
+    private respondersConfig;
+    private botUserId;
+    constructor(settings: DiscordSettings, debug?: boolean);
+    /**
+     * Initialize responder matching from config.
+     */
+    private initializeResponders;
+    /**
+     * Execute a responder and return the result.
+     */
+    private executeResponder;
+    /**
+     * Handle a message that might match a responder.
+     * Returns true if a responder was matched and executed.
+     */
+    private handleResponderMessage;
+    /**
+     * Check if the bot is mentioned in a message.
+     */
+    private isBotMentioned;
+    /**
+     * Remove bot mention from message text.
+     */
+    private removeBotMention;
+    /**
+     * Check if this is a DM (direct message) channel.
+     */
+    private isDMChannel;
+    /**
+     * Check if a guild ID is allowed.
+     */
+    private isGuildAllowed;
+    /**
+     * Check if a channel ID is allowed.
+     */
+    private isChannelAllowed;
+    /**
+     * Convert a Discord message to our ChatMessage format.
+     */
+    private toMessage;
+    /**
+     * Register slash commands with Discord.
+     */
+    private registerSlashCommands;
+    /**
+     * Handle incoming Discord messages.
+     */
+    private handleMessage;
+    /**
+     * Handle slash command interactions.
+     */
+    private handleInteraction;
+    /**
+     * Handle button interactions.
+     */
+    private handleButtonInteraction;
+    connect(onCommand: ChatCommandHandler, onMessage?: ChatMessageHandler): Promise<void>;
+    sendMessage(chatId: string, text: string, options?: SendMessageOptions): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+}
+/**
+ * Create a Discord chat client from settings.
+ */
+export declare function createDiscordClient(settings: DiscordSettings, debug?: boolean): ChatClient;