Merge remote-tracking branch 'origin/main' into sno-test-evidence

Author: snomiao

.bot/AGENT.md

@@ -0,0 +1 @@
+AGENT.md

.bot/CLAUDE.md

@@ -0,0 +1 @@
+AGENT.md

.bot/README.md

@@ -0,0 +1,144 @@
+# Smart Read Feature - Summary
+
+## Overview
+
+Added a new smart `prbot slack read <url>` command that auto-detects Slack URL types and handles them appropriately, making it much easier to interact with Slack content.
+
+## Key Features
+
+### 1. Auto-Detection of URL Types
+
+The command automatically detects three types of Slack URLs:
+
+- **Message URLs**: Reads nearby messages (20 before + 20 after) with target highlighted
+- **Channel URLs**: Reads recent 10 messages from the channel
+- **File URLs**: Downloads file to current directory and returns path info
+
+### 2. Simple Syntax
+
+```bash
+# One command for everything!
+prbot slack read "<slack_url>"
+```
+
+No more remembering different flags for different operations!
+
+### 3. YAML Output
+
+All Slack commands now output YAML format (instead of JSON) for better readability by both humans and AI agents.
+
+## Examples
+
+### Message URL
+
+```bash
+$ prbot slack read "https://workspace.slack.com/archives/C123/p1234567890"
+```
+
+**Output:** YAML with 40 messages (20 before + 20 after), target message has `is_target: true`
+
+### Channel URL
+
+```bash
+$ prbot slack read "https://workspace.slack.com/archives/C123"
+```
+
+**Output:** YAML with 10 most recent messages from the channel
+
+### File URL
+
+```bash
+$ prbot slack read "https://files.slack.com/files-pri/T123-F456/report.pdf"
+```
+
+**Output:** YAML with download info:
+
+```yaml
+type: file_downloaded
+file_id: F456
+file_name: report.pdf
+file_size: 12345
+downloaded_to: ./report.pdf
+```
+
+## Implementation
+
+### New Files Created
+
+1. **lib/slack/parseSlackUrlSmart.ts**
+   - Smart URL parser that detects message/file/channel URLs
+   - Returns structured data with type and extracted info
+
+2. **lib/slack/msg-read-recent.ts**
+   - Function to read recent messages from a channel
+   - Outputs YAML format
+
+### Modified Files
+
+1. **bot/cli.ts**
+   - Added `prbot slack read <url>` command
+   - Updated all Slack commands to output YAML instead of JSON
+   - Imported new smart URL parser
+
+2. **.bot/AGENT.md** (and symlinked README.md, CLAUDE.md)
+   - Added documentation for smart read command
+   - Updated output format mentions from JSON to YAML
+   - Added as recommended method at top of Slack commands section
+
+3. **CLAUDE.md** (root)
+   - Added smart read command documentation
+   - Updated usage patterns to use the new command
+   - Updated implementation details
+
+## Benefits
+
+### For Humans
+
+- **Easier to type**: Just paste the Slack URL, no need to extract channel/timestamp
+- **One command to remember**: Instead of `read-thread`, `read-nearby`, `download-file`, etc.
+- **Better readability**: YAML output is more human-friendly than JSON
+
+### For AI Agents
+
+- **Simpler integration**: Single command interface for all Slack read operations
+- **Better parsing**: YAML is easier to parse and work with than JSON
+- **Consistent output**: All commands follow the same format
+
+## Testing
+
+All URL types parse correctly:
+
+```bash
+# Message URL
+$ bun lib/slack/parseSlackUrlSmart.ts "https://workspace.slack.com/archives/C123/p1234567890"
+{"type":"message","channel":"C123","ts":"1234567890.123456","url":"..."}
+
+# Channel URL
+$ bun lib/slack/parseSlackUrlSmart.ts "https://workspace.slack.com/archives/C123"
+{"type":"channel","channel":"C123","url":"..."}
+
+# File URL
+$ bun lib/slack/parseSlackUrlSmart.ts "https://files.slack.com/files-pri/T123-F456/file.pdf"
+{"type":"file","fileId":"F456","url":"..."}
+```
+
+## Command Help
+
+```
+$ prbot slack --help
+
+Commands:
+  prbot slack read <url>       Smart read: Auto-detect URL type (message/file/channel)
+                               and read appropriately (YAML output)
+  prbot slack update           Update a Slack message
+  prbot slack read-thread      Read and print a Slack thread (YAML)
+  prbot slack read-nearby      Read nearby messages around a specific timestamp
+  prbot slack download-file    Download a file from Slack
+  prbot slack file-info        Get information about a Slack file (YAML)
+  prbot slack post-with-files  Post a message with file attachments
+  prbot slack upload-file      Upload a file to Slack
+```
+
+## Backward Compatibility
+
+All existing commands (`read-thread`, `read-nearby`, `download-file`, etc.) still work exactly as before, just with YAML output instead of JSON. The new `read` command is additive and doesn't break any existing functionality.

.bot/SMART-READ-FEATURE.md

@@ -0,0 +1,22 @@
+---
+name: ComfyUI Code Search
+description: Search code across ComfyUI repositories using comfy-codesearch service. Including all Comfy-Org repos and Community made Custom Node Repos on GitHub.
+---
+
+# ComfyUI Code Search
+
+Search for code patterns, functions, and implementations:
+prbot code search --query "<search terms>"
+
+NOTE: Does NOT support --limit parameter. Results are automatically paginated.
+
+Examples:
+prbot code search --query "binarization" --repo Comfy-Org/ComfyUI
+prbot code search --query "authentication function"
+prbot code search --query "video transcription whisper"
+
+Best practices:
+
+- Use specific function names or patterns for better results.
+- Specify repo when you know which repository to search.
+- Review results and cite file paths and line numbers.

.bot/skills/code-search/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: GitHub Issue Search
+description: Search for issues and pull requests across Comfy-Org repositories.
+---
+
+# GitHub Issue Search
+
+Search issues and PRs across all Comfy-Org repositories:
+prbot github-issue search --query "<search terms>" [--limit=5]
+
+Examples:
+prbot github-issue search --query "authentication bug" --limit 5
+prbot github-issue search --query "dark mode feature"
+
+Best practices:
+
+- Search for known bugs or feature requests before starting work.
+- Reference issue numbers in your responses.
+- Link to relevant discussions and PRs.

.bot/skills/github-issue-search/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: GitHub Changes via pr-bot
+description: Safely make code changes by spawning a coding sub-agent that opens a PR.
+---
+
+# GitHub Changes via pr-bot
+
+All repository modifications must be delegated to the PR bot using the prbot CLI.
+
+Commands:
+prbot pr --repo=<owner/repo> [--branch=<branch>] --prompt="<detailed coding task>"
+prbot code pr --repo=<owner/repo> [--branch=<branch>] --prompt="<detailed coding task>"
+prbot github pr --repo=<owner/repo> [--branch=<branch>] --prompt="<detailed coding task>"
+
+Prompt tips:
+
+- Describe the desired outcome and acceptance criteria.
+- Specify target files/paths when known and include examples.
+- Mention tests/docs to update.

.bot/skills/github-pr-bot/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: Notion Docs Search
+description: Find and cite relevant Notion pages from the Comfy-Org workspace.
+---
+
+# Notion Docs Search
+
+Search internal docs, RFCs, and meeting notes using prbot CLI:
+prbot notion search --query "<search term>" [--limit=5]
+
+Examples:
+prbot notion search --query "ComfyUI setup" --limit 5
+prbot notion search --query "architecture decisions"
+
+Best practices:
+
+- Skim titles and last-edited times; open the most recent first.
+- Cite page titles and URLs in your response.
+- Check for updated information before making recommendations.

.bot/skills/notion-search/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: ComfyUI Registry Search
+description: Search for custom nodes and extensions in the ComfyUI registry.
+---
+
+# ComfyUI Registry Search
+
+Search for custom nodes and plugins:
+prbot registry search --query "<search terms>" [--limit=5]
+
+Examples:
+prbot registry search --query "video" --limit 5
+prbot registry search --query "upscaling models"
+
+Best practices:
+
+- Search for existing custom nodes before recommending new implementations.
+- Provide registry URLs for discovered nodes.
+- Check compatibility and maintenance status.

.bot/skills/registry-search/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: Comfy-Org Repo Reading (Read-Only)
+description: Clone and inspect Comfy-Org repositories for analysis and citations (no direct pushing).
+---
+
+# Comfy-Org Repo Reading (Read-Only)
+
+Clone repositories locally for analysis (read-only):
+mkdir -p ./codes/Comfy-Org
+git clone --depth=1 https://github.com/Comfy-Org/<repo>.git ./codes/Comfy-Org/<repo>
+cd ./codes/Comfy-Org/<repo> && git checkout <branch>
+
+Or use prbot code search for faster results:
+prbot code search --query "<search terms>" --repo Comfy-Org/<repo>
+
+Guidelines:
+
+- Use code search first for specific queries.
+- Clone only when you need to browse full repository structure.
+- Do not commit/push directly; use the PR bot for changes.
+- When citing code, include file paths and line spans where helpful.