agentation 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6eb1491cd99c0a2ec3b1a6157d5f7d28bd5fd861a01d9b775a40ed3b1afd32aa
+  data.tar.gz: 3997f5bd617d66c616128cac4bfc868b8e078546b21760a6198143486e4c487d
+SHA512:
+  metadata.gz: 45466d835b6320a58e927a60f38edf2eb5ff231c171727c7685ca07306c9821839867d6b182379d7213ed33890ec6dc0d1ee41e3e386488235ebd6e11cd14b1f
+  data.tar.gz: a91eeb5d6c53decfa37ef51257861f0b07e9c82ca3177e4780be4d38b4bc5bda9d39d5da385130106227c8601009a816afb36ce7f2ac72cced593e3521ae38fe

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Agentation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,118 @@
+# Agentation Ruby Gem
+
+A Rails engine that provides a floating toolbar for annotating web pages and collecting structured feedback for AI coding agents.
+
+This gem is a Ruby/Rails port of [Agentation](https://agentation.dev/) - the original React-based annotation toolkit created by [Benji Taylor](https://github.com/benjitaylor/agentation).
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'agentation'
+```
+
+Run:
+
+```bash
+bundle install
+rails generate agentation:install
+```
+
+That's it! The generator automatically:
+- Adds the stylesheet to your application.css
+- Adds the JavaScript import to application.js
+- Adds the toolbar helper to your layout
+
+### Manual Installation
+
+If you prefer manual setup or the generator doesn't work for your setup:
+
+**1. Add stylesheet** to `app/assets/stylesheets/application.css`:
+
+```css
+*= require agentation
+```
+
+**2. Import JavaScript** in `app/javascript/application.js`:
+
+```javascript
+import "agentation"
+```
+
+**3. Add toolbar** to your layout (before `</body>`):
+
+```erb
+<%= agentation_toolbar %>
+```
+
+## Usage
+
+The toolbar appears in the bottom-right corner. Click the sparkle icon to activate.
+
+### Options
+
+```erb
+<%= agentation_toolbar(
+  output_detail: "standard",    # compact, standard, detailed, forensic
+  annotation_color: "#3c82f7",  # hex color for markers
+  auto_clear_after_copy: false, # clear annotations after copying
+  dark_mode: true               # dark or light theme
+) %>
+```
+
+## Features
+
+- Click any element to add an annotation
+- Drag to multi-select elements
+- Click marker to edit, Shift+click to delete
+- Copy feedback as structured Markdown
+- Persistent storage (localStorage)
+- Light and dark mode support
+- Draggable toolbar position
+
+## Output Formats
+
+### Compact
+
+```
+1. **button "Submit"**: Make this green
+```
+
+### Standard
+
+```
+### 1. button "Submit"
+**Location:** form > .actions > button
+**Feedback:** Make this green
+```
+
+### Detailed
+
+```
+### 1. button "Submit"
+**Location:** form > .actions > button
+**Classes:** btn, btn-primary
+**Position:** 100px, 200px (120x40px)
+**Feedback:** Make this green
+```
+
+### Forensic
+
+Full debugging information including computed styles, accessibility info, and nearby elements.
+
+## Requirements
+
+- Rails 6.1+
+- Ruby 3.0+
+
+## Credits
+
+This Ruby gem is based on [Agentation](https://agentation.dev/), an open-source annotation toolkit for AI coding agents.
+
+- **Original Project:** [github.com/benjitaylor/agentation](https://github.com/benjitaylor/agentation)
+- **Website:** [agentation.dev](https://agentation.dev/)
+
+## License
+
+MIT