PyPI - agent-notes - Versions diffs - 2.0.4__py3-none-any.whl - Mend

agent-notes 2.0.4__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (162) hide show

agent_notes/VERSION +1 -0
agent_notes/__init__.py +1 -0
agent_notes/__main__.py +4 -0
agent_notes/cli.py +348 -0
agent_notes/commands/__init__.py +27 -0
agent_notes/commands/_install_helpers.py +262 -0
agent_notes/commands/build.py +170 -0
agent_notes/commands/doctor.py +112 -0
agent_notes/commands/info.py +95 -0
agent_notes/commands/install.py +99 -0
agent_notes/commands/list.py +169 -0
agent_notes/commands/memory.py +430 -0
agent_notes/commands/regenerate.py +152 -0
agent_notes/commands/set_role.py +143 -0
agent_notes/commands/uninstall.py +26 -0
agent_notes/commands/update.py +169 -0
agent_notes/commands/validate.py +199 -0
agent_notes/commands/wizard.py +720 -0
agent_notes/config.py +154 -0
agent_notes/data/agents/agents.yaml +352 -0
agent_notes/data/agents/analyst.md +45 -0
agent_notes/data/agents/api-reviewer.md +47 -0
agent_notes/data/agents/architect.md +46 -0
agent_notes/data/agents/coder.md +28 -0
agent_notes/data/agents/database-specialist.md +45 -0
agent_notes/data/agents/debugger.md +47 -0
agent_notes/data/agents/devil.md +47 -0
agent_notes/data/agents/devops.md +38 -0
agent_notes/data/agents/explorer.md +23 -0
agent_notes/data/agents/integrations.md +44 -0
agent_notes/data/agents/lead.md +216 -0
agent_notes/data/agents/performance-profiler.md +44 -0
agent_notes/data/agents/refactorer.md +48 -0
agent_notes/data/agents/reviewer.md +44 -0
agent_notes/data/agents/security-auditor.md +44 -0
agent_notes/data/agents/system-auditor.md +38 -0
agent_notes/data/agents/tech-writer.md +32 -0
agent_notes/data/agents/test-runner.md +36 -0
agent_notes/data/agents/test-writer.md +39 -0
agent_notes/data/cli/claude.yaml +25 -0
agent_notes/data/cli/copilot.yaml +18 -0
agent_notes/data/cli/opencode.yaml +22 -0
agent_notes/data/commands/brainstorm.md +8 -0
agent_notes/data/commands/debug.md +9 -0
agent_notes/data/commands/review.md +10 -0
agent_notes/data/global-claude.md +290 -0
agent_notes/data/global-copilot.md +27 -0
agent_notes/data/global-opencode.md +40 -0
agent_notes/data/hooks/session-context.md.tpl +19 -0
agent_notes/data/models/claude-haiku-4-5.yaml +15 -0
agent_notes/data/models/claude-opus-4-1.yaml +16 -0
agent_notes/data/models/claude-opus-4-5.yaml +16 -0
agent_notes/data/models/claude-opus-4-6.yaml +16 -0
agent_notes/data/models/claude-opus-4-7.yaml +15 -0
agent_notes/data/models/claude-sonnet-4-5.yaml +16 -0
agent_notes/data/models/claude-sonnet-4-6.yaml +15 -0
agent_notes/data/models/claude-sonnet-4.yaml +16 -0
agent_notes/data/pricing.yaml +33 -0
agent_notes/data/roles/orchestrator.yaml +5 -0
agent_notes/data/roles/reasoner.yaml +5 -0
agent_notes/data/roles/scout.yaml +5 -0
agent_notes/data/roles/worker.yaml +5 -0
agent_notes/data/rules/code-quality.md +9 -0
agent_notes/data/rules/safety.md +10 -0
agent_notes/data/scripts/cost-report +211 -0
agent_notes/data/skills/brainstorming/SKILL.md +57 -0
agent_notes/data/skills/code-review/SKILL.md +64 -0
agent_notes/data/skills/debugging-protocol/SKILL.md +51 -0
agent_notes/data/skills/docker-compose/SKILL.md +318 -0
agent_notes/data/skills/docker-compose-advanced/SKILL.md +575 -0
agent_notes/data/skills/docker-dockerfile/SKILL.md +385 -0
agent_notes/data/skills/docker-dockerfile-languages/SKILL.md +293 -0
agent_notes/data/skills/git/SKILL.md +87 -0
agent_notes/data/skills/rails-active-storage/SKILL.md +321 -0
agent_notes/data/skills/rails-broadcasting/SKILL.md +374 -0
agent_notes/data/skills/rails-concerns/SKILL.md +806 -0
agent_notes/data/skills/rails-controllers/SKILL.md +510 -0
agent_notes/data/skills/rails-controllers-advanced/SKILL.md +441 -0
agent_notes/data/skills/rails-helpers/SKILL.md +677 -0
agent_notes/data/skills/rails-initializers/SKILL.md +79 -0
agent_notes/data/skills/rails-javascript/SKILL.md +567 -0
agent_notes/data/skills/rails-jobs/SKILL.md +700 -0
agent_notes/data/skills/rails-kamal/SKILL.md +483 -0
agent_notes/data/skills/rails-lib/SKILL.md +101 -0
agent_notes/data/skills/rails-mailers/SKILL.md +321 -0
agent_notes/data/skills/rails-migrations/SKILL.md +268 -0
agent_notes/data/skills/rails-models/SKILL.md +459 -0
agent_notes/data/skills/rails-models-advanced/SKILL.md +398 -0
agent_notes/data/skills/rails-routes/SKILL.md +804 -0
agent_notes/data/skills/rails-style/SKILL.md +538 -0
agent_notes/data/skills/rails-testing-controllers/SKILL.md +343 -0
agent_notes/data/skills/rails-testing-models/SKILL.md +296 -0
agent_notes/data/skills/rails-testing-system/SKILL.md +375 -0
agent_notes/data/skills/rails-validations/SKILL.md +108 -0
agent_notes/data/skills/rails-view-components/SKILL.md +511 -0
agent_notes/data/skills/rails-view-components-advanced/SKILL.md +376 -0
agent_notes/data/skills/rails-views/SKILL.md +413 -0
agent_notes/data/skills/rails-views-advanced/SKILL.md +450 -0
agent_notes/data/skills/refactoring-protocol/SKILL.md +64 -0
agent_notes/data/skills/tdd/SKILL.md +57 -0
agent_notes/data/templates/__init__.py +1 -0
agent_notes/data/templates/__pycache__/__init__.cpython-314.pyc +0 -0
agent_notes/data/templates/frontmatter/__init__.py +1 -0
agent_notes/data/templates/frontmatter/__pycache__/__init__.cpython-314.pyc +0 -0
agent_notes/data/templates/frontmatter/__pycache__/claude.cpython-314.pyc +0 -0
agent_notes/data/templates/frontmatter/__pycache__/cursor.cpython-314.pyc +0 -0
agent_notes/data/templates/frontmatter/__pycache__/opencode.cpython-314.pyc +0 -0
agent_notes/data/templates/frontmatter/claude.py +44 -0
agent_notes/data/templates/frontmatter/opencode.py +104 -0
agent_notes/doctor_checks.py +189 -0
agent_notes/domain/__init__.py +17 -0
agent_notes/domain/agent.py +34 -0
agent_notes/domain/cli_backend.py +40 -0
agent_notes/domain/diagnostics.py +29 -0
agent_notes/domain/diff.py +44 -0
agent_notes/domain/model.py +27 -0
agent_notes/domain/role.py +13 -0
agent_notes/domain/rule.py +13 -0
agent_notes/domain/skill.py +15 -0
agent_notes/domain/state.py +46 -0
agent_notes/install_state.py +11 -0
agent_notes/registries/__init__.py +16 -0
agent_notes/registries/_base.py +46 -0
agent_notes/registries/agent_registry.py +107 -0
agent_notes/registries/cli_registry.py +89 -0
agent_notes/registries/model_registry.py +85 -0
agent_notes/registries/role_registry.py +64 -0
agent_notes/registries/rule_registry.py +80 -0
agent_notes/registries/skill_registry.py +141 -0
agent_notes/services/__init__.py +8 -0
agent_notes/services/diagnostics/__init__.py +47 -0
agent_notes/services/diagnostics/_checks.py +272 -0
agent_notes/services/diagnostics/_display.py +346 -0
agent_notes/services/diagnostics/_fix.py +169 -0
agent_notes/services/diff.py +349 -0
agent_notes/services/fs.py +195 -0
agent_notes/services/install_state_builder.py +210 -0
agent_notes/services/installer.py +293 -0
agent_notes/services/memory_backend.py +155 -0
agent_notes/services/rendering.py +329 -0
agent_notes/services/session_context.py +23 -0
agent_notes/services/settings_writer.py +79 -0
agent_notes/services/state_store.py +249 -0
agent_notes/services/ui.py +419 -0
agent_notes/services/user_config.py +62 -0
agent_notes/services/validation.py +67 -0
agent_notes/state.py +21 -0
agent_notes-2.0.4.dist-info/METADATA +14 -0
agent_notes-2.0.4.dist-info/RECORD +162 -0
agent_notes-2.0.4.dist-info/WHEEL +5 -0
agent_notes-2.0.4.dist-info/entry_points.txt +2 -0
agent_notes-2.0.4.dist-info/licenses/LICENSE +21 -0
agent_notes-2.0.4.dist-info/top_level.txt +2 -0
tests/conftest.py +20 -0
tests/functional/__init__.py +0 -0
tests/functional/test_build_commands.py +88 -0
tests/functional/test_registries.py +128 -0
tests/integration/__init__.py +0 -0
tests/integration/test_build_output.py +129 -0
tests/plugins/__init__.py +0 -0
tests/plugins/test_agents.py +93 -0
tests/plugins/test_skills.py +77 -0

agent_notes/data/skills/rails-mailers/SKILL.md ADDED Viewed

@@ -0,0 +1,321 @@
+---
+name: rails-mailers
+description: "Rails Action Mailer: templates, layouts, attachments, previews, and testing"
+group: rails
+---
+# Mailers Guide
+Comprehensive guide for Rails Action Mailer.
+---
+## Philosophy
+1. **Mailers are like controllers** - Thin, delegate to models
+2. **Preview mailers in development** - Use mailer previews
+3. **Test email delivery** - Test content, not delivery mechanism
+4. **Layouts for consistency** - DRY up email HTML
+5. **Plain text + HTML** - Always provide both formats
+---
+## File Structure
+```
+app/mailers/
+├── application_mailer.rb
+├── user_mailer.rb
+├── notification_mailer.rb
+└── magic_link_mailer.rb
+app/views/
+├── layouts/
+│   └── mailer.html.erb
+└── user_mailer/
+    ├── welcome.html.erb
+    └── welcome.text.erb
+```
+---
+## Basic Mailer
+### Application Mailer
+```ruby
+# app/mailers/application_mailer.rb
+class ApplicationMailer < ActionMailer::Base
+  default from: ENV.fetch("MAILER_FROM_ADDRESS", "App <noreply@example.com>")
+  layout "mailer"
+  helper ApplicationHelper, UsersHelper
+  private
+    def default_url_options
+      if Current.account
+        super.merge(script_name: Current.account.slug)
+      else
+        super
+      end
+    end
+end
+```
+### Simple Mailer
+```ruby
+# app/mailers/user_mailer.rb
+class UserMailer < ApplicationMailer
+  def welcome(user)
+    @user = user
+    @login_url = new_session_url
+    mail to: @user.email, subject: "Welcome to #{app_name}!"
+  end
+  def password_reset(user, token)
+    @user = user
+    @token = token
+    @reset_url = edit_password_url(token: @token)
+    mail to: @user.email, subject: "Reset your password"
+  end
+  private
+    def app_name
+      "My App"
+    end
+end
+```
+---
+## Templates
+### HTML Template
+```erb
+<%# app/views/user_mailer/welcome.html.erb %>
+<h1>Welcome, <%= @user.name %>!</h1>
+<p>Thanks for signing up. We're excited to have you on board.</p>
+<p>
+  <%= link_to "Get Started", @login_url, class: "button" %>
+</p>
+<p>
+  If you have any questions, just reply to this email.
+</p>
+<p>
+  Thanks,<br>
+  The Team
+</p>
+```
+### Plain Text Template
+```erb
+<%# app/views/user_mailer/welcome.text.erb %>
+Welcome, <%= @user.name %>!
+Thanks for signing up. We're excited to have you on board.
+Get started: <%= @login_url %>
+If you have any questions, just reply to this email.
+Thanks,
+The Team
+```
+### Mailer Layout
+```erb
+<%# app/views/layouts/mailer.html.erb %>
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+    <style>
+      body { font-family: Arial, sans-serif; line-height: 1.6; }
+      .button { background: #007bff; color: white; padding: 10px 20px; text-decoration: none; }
+    </style>
+  </head>
+  <body>
+    <%= yield %>
+    <hr>
+    <p style="font-size: 12px; color: #666;">
+      You're receiving this email because you have an account at My App.
+    </p>
+  </body>
+</html>
+```
+---
+## Mailer Methods
+### With Attachments
+```ruby
+def invoice(user, invoice)
+  @user = user
+  @invoice = invoice
+  attachments["invoice-#{@invoice.id}.pdf"] = @invoice.to_pdf
+  attachments.inline["logo.png"] = File.read(Rails.root.join("app/assets/images/logo.png"))
+  mail to: @user.email, subject: "Invoice ##{@invoice.id}"
+end
+```
+### With CC/BCC
+```ruby
+def notification(user, admin)
+  @user = user
+  mail(
+    to: @user.email,
+    cc: admin.email,
+    bcc: "notifications@example.com",
+    subject: "Important Update"
+  )
+end
+```
+### With Custom Headers
+```ruby
+def custom_email(user)
+  @user = user
+  headers["X-Priority"] = "1"
+  headers["X-Mailer"] = "MyApp Mailer"
+  mail to: @user.email, subject: "Custom Email"
+end
+```
+---
+## Sending Emails
+### Immediate Delivery
+```ruby
+# Sends immediately
+UserMailer.welcome(user).deliver_now
+```
+### Background Delivery
+```ruby
+# Enqueues job
+UserMailer.welcome(user).deliver_later
+# With delay
+UserMailer.welcome(user).deliver_later(wait: 1.hour)
+# At specific time
+UserMailer.welcome(user).deliver_later(wait_until: Time.current + 2.hours)
+```
+### From Models
+```ruby
+class User < ApplicationRecord
+  after_create :send_welcome_email
+  private
+    def send_welcome_email
+      UserMailer.welcome(self).deliver_later
+    end
+end
+```
+---
+## Mailer Previews
+### Preview Class
+```ruby
+# test/mailers/previews/user_mailer_preview.rb
+class UserMailerPreview < ActionMailer::Preview
+  def welcome
+    UserMailer.welcome(User.first)
+  end
+  def password_reset
+    user = User.first
+    token = "sample-token-123"
+    UserMailer.password_reset(user, token)
+  end
+end
+# Visit: http://localhost:3000/rails/mailers
+```
+---
+## Testing Mailers
+### Basic Mailer Test
+```ruby
+class UserMailerTest < ActionMailer::TestCase
+  test "welcome email" do
+    user = users(:david)
+    email = UserMailer.welcome(user)
+    assert_emails 1 do
+      email.deliver_now
+    end
+    assert_equal [user.email], email.to
+    assert_equal "Welcome to My App!", email.subject
+    assert_match user.name, email.body.encoded
+    assert_match "Get Started", email.body.encoded
+  end
+  test "welcome email includes login URL" do
+    user = users(:david)
+    email = UserMailer.welcome(user)
+    assert_match new_session_url, email.body.encoded
+  end
+  test "email has both HTML and text parts" do
+    user = users(:david)
+    email = UserMailer.welcome(user)
+    assert_equal 2, email.parts.size
+    assert_equal "text/plain", email.text_part.content_type
+    assert_equal "text/html", email.html_part.content_type
+  end
+end
+```
+---
+## Summary
+- **Structure**: Like controllers, thin and focused
+- **Templates**: HTML + plain text versions
+- **Layouts**: DRY up common email structure
+- **Delivery**: Immediate or background (deliver_later)
+- **Testing**: Test content, recipients, attachments
+- **Previews**: Preview emails in development

agent_notes/data/skills/rails-migrations/SKILL.md ADDED Viewed

@@ -0,0 +1,268 @@
+---
+name: rails-migrations
+description: "Rails database migrations: tables, columns, indexes, foreign keys, and best practices"
+group: rails
+---
+# Migrations Guide
+Comprehensive guide for Rails database migrations.
+---
+## File Structure
+```
+db/migrate/
+├── 20250101120000_create_cards.rb
+├── 20250102130000_add_status_to_cards.rb
+└── 20250103140000_create_index_on_cards_board_id.rb
+```
+---
+## Basic Migration Patterns
+### Create Table
+```ruby
+class CreateCards < ActiveRecord::Migration[8.0]
+  def change
+    create_table :cards, id: :uuid do |t|
+      t.uuid :account_id, null: false
+      t.uuid :board_id, null: false
+      t.uuid :creator_id, null: false
+      t.integer :number, null: false
+      t.string :title
+      t.text :description
+      t.string :status, default: "draft", null: false
+      t.string :color
+      t.timestamps
+      t.index ["account_id", "number"], unique: true
+      t.index ["board_id"]
+      t.index ["creator_id"]
+      t.index ["status"]
+    end
+  end
+end
+```
+### Add Column
+```ruby
+class AddPublishedAtToCards < ActiveRecord::Migration[8.0]
+  def change
+    add_column :cards, :published_at, :datetime
+    add_index :cards, :published_at
+  end
+end
+```
+### Remove Column
+```ruby
+class RemoveDeprecatedFieldFromCards < ActiveRecord::Migration[8.0]
+  def change
+    remove_column :cards, :deprecated_field, :string
+  end
+end
+```
+### Change Column
+```ruby
+class ChangeCardsTitleToText < ActiveRecord::Migration[8.0]
+  def change
+    change_column :cards, :title, :text
+  end
+end
+# Or with up/down for safety
+class ChangeCardsTitleToText < ActiveRecord::Migration[8.0]
+  def up
+    change_column :cards, :title, :text
+  end
+  def down
+    change_column :cards, :title, :string
+  end
+end
+```
+### Rename Column
+```ruby
+class RenameCardsDescToDescription < ActiveRecord::Migration[8.0]
+  def change
+    rename_column :cards, :desc, :description
+  end
+end
+```
+---
+## Index Patterns
+### Single Column Index
+```ruby
+add_index :cards, :board_id
+add_index :cards, :status
+```
+### Composite Index
+```ruby
+add_index :cards, [:account_id, :number], unique: true
+add_index :cards, [:board_id, :status]
+```
+### Named Index
+```ruby
+add_index :cards, :email, unique: true, name: "idx_cards_on_email"
+```
+### Partial Index (PostgreSQL)
+```ruby
+add_index :cards, :published_at, where: "status = 'published'"
+```
+### Remove Index
+```ruby
+remove_index :cards, :board_id
+remove_index :cards, name: "idx_cards_on_email"
+```
+---
+## Foreign Keys
+```ruby
+class AddForeignKeys < ActiveRecord::Migration[8.0]
+  def change
+    add_foreign_key :cards, :boards
+    add_foreign_key :cards, :accounts
+    add_foreign_key :cards, :users, column: :creator_id
+  end
+end
+```
+---
+## Data Migrations
+### Backfill Data
+```ruby
+class BackfillCardNumbers < ActiveRecord::Migration[8.0]
+  def up
+    Card.where(number: nil).find_each do |card|
+      card.update!(number: card.account.increment!(:cards_count).cards_count)
+    end
+  end
+  def down
+    # Usually no rollback for data migrations
+  end
+end
+```
+---
+## UUID Primary Keys
+```ruby
+class EnableUuidExtension < ActiveRecord::Migration[8.0]
+  def change
+    enable_extension "pgcrypto"  # PostgreSQL
+  end
+end
+class CreateCardsWithUuid < ActiveRecord::Migration[8.0]
+  def change
+    create_table :cards, id: :uuid do |t|
+      t.uuid :account_id, null: false
+      t.timestamps
+    end
+  end
+end
+```
+---
+## Reversible Migrations
+```ruby
+class AddCheckConstraint < ActiveRecord::Migration[8.0]
+  def change
+    reversible do |dir|
+      dir.up do
+        execute <<-SQL
+          ALTER TABLE cards
+          ADD CONSTRAINT check_positive_number
+          CHECK (number > 0)
+        SQL
+      end
+      dir.down do
+        execute <<-SQL
+          ALTER TABLE cards
+          DROP CONSTRAINT check_positive_number
+        SQL
+      end
+    end
+  end
+end
+```
+---
+## Best Practices
+### ✅ DO
+1. **Add indexes for foreign keys**
+```ruby
+t.uuid :board_id, null: false
+t.index [:board_id]
+```
+2. **Use null constraints**
+```ruby
+t.string :title, null: false
+```
+3. **Add default values**
+```ruby
+t.string :status, default: "draft", null: false
+```
+4. **Use change when possible**
+```ruby
+def change
+  add_column :cards, :color, :string
+end
+```
+### ❌ DON'T
+1. **Modify old migrations** - Create new ones
+2. **Remove columns in production without deprecation**
+3. **Change column types without considering data loss**
+---
+## Summary
+- **Versioned**: Each migration is timestamped
+- **Reversible**: Use `change` when possible
+- **Indexes**: Add for foreign keys and frequently queried columns
+- **Constraints**: Use null, default, unique appropriately
+- **Data Migrations**: Separate from schema migrations
+- **UUID Keys**: Use for distributed systems