aven 0.0.3

data/db/migrate/20200101000015_create_aven_agentic_agents.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+class CreateAvenAgenticAgents < ActiveRecord::Migration[8.0]
+  def change
+    create_table :aven_agentic_agents do |t|
+      t.references :workspace, null: false, foreign_key: { to_table: :aven_workspaces }
+      t.string :label, null: false
+      t.string :slug
+      t.text :system_prompt
+      t.text :user_facing_question
+      t.boolean :enabled, default: true, null: false
+      t.timestamps
+    end
+
+    add_index :aven_agentic_agents, [:workspace_id, :slug], unique: true
+    add_index :aven_agentic_agents, :enabled
+  end
+end

data/db/migrate/20200101000016_create_aven_agentic_agent_tools.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+class CreateAvenAgenticAgentTools < ActiveRecord::Migration[8.0]
+  def change
+    create_table :aven_agentic_agent_tools do |t|
+      t.references :agent, null: false, foreign_key: { to_table: :aven_agentic_agents }
+      t.references :tool, null: false, foreign_key: { to_table: :aven_agentic_tools }
+      t.timestamps
+    end
+
+    add_index :aven_agentic_agent_tools, [:agent_id, :tool_id], unique: true
+  end
+end

data/db/migrate/20200101000017_create_aven_agentic_agent_documents.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+class CreateAvenAgenticAgentDocuments < ActiveRecord::Migration[8.0]
+  def change
+    create_table :aven_agentic_agent_documents do |t|
+      t.references :agent, null: false, foreign_key: { to_table: :aven_agentic_agents }
+      t.references :document, null: false, foreign_key: { to_table: :aven_agentic_documents }
+      t.timestamps
+    end
+
+    add_index :aven_agentic_agent_documents, [:agent_id, :document_id], unique: true
+  end
+end

data/db/migrate/20200101000018_create_aven_chat_threads.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+class CreateAvenChatThreads < ActiveRecord::Migration[8.0]
+  def change
+    create_table :aven_chat_threads do |t|
+      t.references :workspace, null: false, foreign_key: { to_table: :aven_workspaces }
+      t.references :user, null: false, foreign_key: { to_table: :aven_users }
+      t.references :agent, foreign_key: { to_table: :aven_agentic_agents }
+      t.string :title
+      t.jsonb :tools, default: nil           # Locked tool names array
+      t.jsonb :documents, default: nil       # Locked document IDs array
+      t.text :context_markdown
+      t.timestamps
+    end
+
+    add_index :aven_chat_threads, [:workspace_id, :user_id]
+    add_index :aven_chat_threads, :created_at
+  end
+end

data/db/migrate/20200101000019_create_aven_chat_messages.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+class CreateAvenChatMessages < ActiveRecord::Migration[8.0]
+  def change
+    create_table :aven_chat_messages do |t|
+      t.references :thread, null: false, foreign_key: { to_table: :aven_chat_threads }
+      t.references :parent, foreign_key: { to_table: :aven_chat_messages }
+      t.string :role, null: false                 # user, assistant, tool, system
+      t.string :status, default: "pending"        # pending, streaming, success, error
+      t.text :content
+      t.string :model
+      t.integer :input_tokens, default: 0
+      t.integer :output_tokens, default: 0
+      t.integer :total_tokens, default: 0
+      t.decimal :cost_usd, precision: 10, scale: 6, default: 0.0
+      t.datetime :started_at
+      t.datetime :completed_at
+      t.jsonb :tool_call, default: nil            # Tool call details
+      t.timestamps
+    end
+
+    add_index :aven_chat_messages, :role
+    add_index :aven_chat_messages, :status
+    add_index :aven_chat_messages, [:thread_id, :created_at]
+  end
+end

data/db/migrate/20200101000020_add_pg_search_support.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+class AddPgSearchSupport < ActiveRecord::Migration[8.0]
+  def up
+    # Enable pg_trgm for fuzzy matching
+    enable_extension "pg_trgm"
+
+    # Create pg_search_documents table for multi-search
+    create_table :pg_search_documents do |t|
+      t.text :content
+      t.belongs_to :searchable, polymorphic: true, index: true
+      t.belongs_to :workspace, foreign_key: { to_table: :aven_workspaces }, index: true
+      t.timestamps null: false
+    end
+  end
+
+  def down
+    drop_table :pg_search_documents
+    disable_extension "pg_trgm"
+  end
+end

data/db/migrate/20200101000021_create_aven_item_schemas.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+class CreateAvenItemSchemas < ActiveRecord::Migration[8.0]
+  def change
+    create_table :aven_item_schemas do |t|
+      t.references :workspace, null: false, foreign_key: { to_table: :aven_workspaces }
+      t.string :slug, null: false
+      t.jsonb :schema, null: false, default: {}
+      t.jsonb :fields, null: false, default: {}
+      t.jsonb :embeds, null: false, default: {}
+      t.jsonb :links, null: false, default: {}
+      t.timestamps
+    end
+
+    add_index :aven_item_schemas, [:workspace_id, :slug], unique: true
+    add_index :aven_item_schemas, :slug
+  end
+end

data/db/migrate/20200101000022_create_aven_imports.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+class CreateAvenImports < ActiveRecord::Migration[8.0]
+  def change
+    create_table :aven_imports do |t|
+      t.references :workspace, null: false, foreign_key: { to_table: :aven_workspaces }
+      t.string :source, null: false
+      t.string :status, null: false, default: "pending"
+      t.integer :total_count, default: 0
+      t.integer :processed_count, default: 0
+      t.integer :imported_count, default: 0
+      t.integer :skipped_count, default: 0
+      t.text :error_message
+      t.jsonb :errors_log, default: []
+      t.datetime :started_at
+      t.datetime :completed_at
+      t.timestamps
+    end
+
+    add_index :aven_imports, :source
+    add_index :aven_imports, :status
+  end
+end

data/db/migrate/20200101000023_create_aven_import_entries.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+class CreateAvenImportEntries < ActiveRecord::Migration[8.0]
+  def change
+    create_table :aven_import_entries do |t|
+      t.references :import, null: false, foreign_key: { to_table: :aven_imports }
+      t.jsonb :data, null: false, default: {}
+      t.timestamps
+    end
+
+    add_index :aven_import_entries, :data, using: :gin
+  end
+end

data/db/migrate/20200101000024_create_aven_import_item_links.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+class CreateAvenImportItemLinks < ActiveRecord::Migration[8.0]
+  def change
+    create_table :aven_import_item_links do |t|
+      t.references :entry, null: false, foreign_key: { to_table: :aven_import_entries }
+      t.references :item, null: false, foreign_key: { to_table: :aven_items }
+      t.timestamps
+    end
+
+    add_index :aven_import_item_links, [:entry_id, :item_id], unique: true
+  end
+end

data/db/migrate/20200101000025_create_aven_articles.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+class CreateAvenArticles < ActiveRecord::Migration[8.0]
+  def change
+    create_table :aven_articles do |t|
+      t.references :workspace, null: false, foreign_key: { to_table: :aven_workspaces }
+      t.references :author, null: true, foreign_key: { to_table: :aven_users }
+      t.string :title, null: false
+      t.string :slug
+      t.text :intro
+      t.text :description
+      t.datetime :published_at
+      t.timestamps
+    end
+
+    add_index :aven_articles, [:workspace_id, :slug], unique: true
+    add_index :aven_articles, :published_at
+  end
+end

data/db/migrate/20200101000026_create_aven_article_attachments.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+class CreateAvenArticleAttachments < ActiveRecord::Migration[8.0]
+  def change
+    create_table :aven_article_attachments do |t|
+      t.references :article, null: false, foreign_key: { to_table: :aven_articles }
+      t.integer :position, default: 0, null: false
+      t.timestamps
+    end
+
+    add_index :aven_article_attachments, [:article_id, :position]
+  end
+end

data/db/migrate/20200101000027_create_aven_article_relationships.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class CreateAvenArticleRelationships < ActiveRecord::Migration[8.0]
+  def change
+    create_table :aven_article_relationships do |t|
+      t.references :article, null: false, foreign_key: { to_table: :aven_articles }
+      t.references :related_article, null: false, foreign_key: { to_table: :aven_articles }
+      t.integer :position, default: 0
+      t.timestamps
+    end
+
+    add_index :aven_article_relationships, [:article_id, :related_article_id], unique: true, name: "idx_article_relationships_unique"
+    add_index :aven_article_relationships, [:article_id, :position]
+  end
+end

data/lib/aven/configuration.rb

@@ -0,0 +1,87 @@
+module Aven
+  class Configuration
+    attr_accessor :authenticated_root_path
+    attr_accessor :oauth_providers
+    attr_accessor :agentic
+    attr_accessor :ocr
+
+    def initialize
+      @authenticated_root_path = nil
+      @oauth_providers = {}
+      @agentic = AgenticConfiguration.new
+      @ocr = OcrConfiguration.new
+    end
+
+    # Configure OAuth providers
+    #
+    # @param provider [Symbol] The OAuth provider name (:github, :google, etc.)
+    # @param credentials [Hash] Configuration hash with:
+    #   - :client_id [String] OAuth client ID
+    #   - :client_secret [String] OAuth client secret
+    #   - :scope [String] Optional. OAuth scopes to request
+    #   - Any other provider-specific options
+    #
+    # @example
+    #   config.configure_oauth(:github, {
+    #     client_id: "abc123",
+    #     client_secret: "secret",
+    #     scope: "user:email,repo,workflow"
+    #   })
+    def configure_oauth(provider, credentials = {})
+      @oauth_providers[provider.to_sym] = credentials
+    end
+
+    # Resolves authenticated_root_path, calling it if it's a lambda/proc
+    #
+    # @return [String] The resolved path
+    def resolve_authenticated_root_path
+      return nil if @authenticated_root_path.nil?
+
+      @authenticated_root_path.respond_to?(:call) ? @authenticated_root_path.call : @authenticated_root_path
+    end
+  end
+
+  # Agentic configuration (LLM, tools, chat)
+  class AgenticConfiguration
+    attr_accessor :default_model
+    attr_accessor :system_prompt
+    attr_accessor :tools_enabled
+    attr_accessor :mcp_enabled
+    attr_accessor :mcp_api_token
+
+    def initialize
+      @default_model = "claude-sonnet-4-5-20250929"
+      @system_prompt = "You are a helpful assistant."
+      @tools_enabled = true
+      @mcp_enabled = false
+      @mcp_api_token = nil
+    end
+  end
+
+  # OCR configuration
+  class OcrConfiguration
+    attr_accessor :provider
+    attr_accessor :aws_region
+    attr_accessor :aws_access_key_id
+    attr_accessor :aws_secret_access_key
+
+    def initialize
+      @provider = nil  # :textract, :google_vision, etc.
+      @aws_region = nil
+      @aws_access_key_id = nil
+      @aws_secret_access_key = nil
+    end
+  end
+
+  class << self
+    attr_writer :configuration
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+  end
+end

data/lib/aven/engine.rb

@@ -0,0 +1,43 @@
+require "importmap-rails"
+require "view_component-contrib"
+require "dry-effects"
+require "json_skooma"
+require "aeno"
+require "friendly_id"
+require "acts-as-taggable-on"
+require "aven/model"
+
+module Aven
+  class << self
+    attr_accessor :importmap
+  end
+
+  class Engine < ::Rails::Engine
+    isolate_namespace Aven
+
+    Aeno::EngineHelpers.setup_assets(self, namespace: Aven)
+    Aeno::EngineHelpers.setup_importmap(self, namespace: Aven)
+
+    # Append engine migrations to the main app
+    initializer :append_migrations do |app|
+      unless app.root.to_s.include?("test/dummy")
+        config.paths["db/migrate"].expanded.each do |expanded_path|
+          app.config.paths["db/migrate"] << expanded_path
+        end
+      end
+    end
+
+    # Include engine route helpers, authentication, and controller helpers in controllers and views
+    initializer "aven.helpers" do
+      ActiveSupport.on_load(:action_controller) do
+        include Aven::Engine.routes.url_helpers
+        include Aven::Authentication
+        include Aven::ControllerHelpers
+      end
+
+      ActiveSupport.on_load(:action_view) do
+        include Aven::Engine.routes.url_helpers
+      end
+    end
+  end
+end

data/lib/aven/model/tenant_model.rb

@@ -0,0 +1,91 @@
+module Aven
+  module Model
+    # TenantModel provides workspace multi-tenancy support for ActiveRecord models.
+    #
+    # Usage:
+    #   class Server < ApplicationRecord
+    #     include Aven::TenantModel
+    #   end
+    #
+    # This will:
+    # - Add belongs_to :workspace association
+    # - Validate workspace_id column exists
+    # - Register model with Aven::Workspace
+    # - Add workspace scoping helpers
+    #
+    # Inspired by Flipper's Model::ActiveRecord pattern.
+    module TenantModel
+      extend ActiveSupport::Concern
+
+      included do
+        # Validate workspace_id column exists at include time (skip during migrations)
+        if table_exists? && !column_names.include?("workspace_id")
+          raise ArgumentError,
+            "#{name} includes Aven::TenantModel but does not have a workspace_id column. " \
+            "Add a workspace_id column to #{table_name} first."
+        end
+
+        # Add belongs_to association if not already defined
+        unless reflect_on_association(:workspace)
+          belongs_to :workspace, class_name: "Aven::Workspace"
+        end
+
+        # Register this model as a tenant model
+        Aven::Workspace.register_tenant_model(self)
+
+        # Add scopes for workspace querying
+        scope :in_workspace, ->(workspace) { where(workspace_id: workspace.id) }
+        scope :for_workspace, ->(workspace) { where(workspace_id: workspace.id) }
+      end
+
+      # Returns a unique identifier combining class name and workspace_id
+      # Useful for caching keys, logging, permissions, etc.
+      #
+      # Example:
+      #   server.workspace_tenant_id #=> "Server;123"
+      def workspace_tenant_id
+        "#{self.class.base_class.name};#{workspace_id}"
+      end
+
+      # Check if this model is workspace-scoped
+      def workspace_scoped?
+        true
+      end
+
+      # Returns workspace association name for this model type
+      def workspace_association_name
+        self.class.workspace_association_name
+      end
+
+      module ClassMethods
+        # Make workspace association optional
+        # Call this in your model if workspace can be nil
+        #
+        # Example:
+        #   class DnsCredential < ApplicationRecord
+        #     include Aven::TenantModel
+        #     workspace_optional!
+        #   end
+        def workspace_optional!
+          _reflect_on_association(:workspace).options[:optional] = true
+        end
+
+        # Returns the association name that Workspace will use for this model
+        # Example: Server => :servers, DnsCredential => :dns_credentials
+        def workspace_association_name
+          name.underscore.pluralize.to_sym
+        end
+
+        # Check if this model has a unique workspace constraint
+        # Used to determine if Workspace should use has_one vs has_many
+        def unique_per_workspace?
+          return false unless table_exists?
+
+          connection.indexes(table_name).any? { |idx|
+            idx.unique && idx.columns == [ "workspace_id" ]
+          }
+        end
+      end
+    end
+  end
+end

data/lib/aven/model.rb

@@ -0,0 +1,6 @@
+require "aven/model/tenant_model"
+
+module Aven
+  module Model
+  end
+end

data/lib/aven/version.rb

@@ -0,0 +1,3 @@
+module Aven
+  VERSION = "0.0.3"
+end

data/lib/aven.rb

@@ -0,0 +1,8 @@
+require "aven/version"
+require "aven/configuration"
+require "aven/engine"
+require "neighbor"
+require "ruby_llm"
+
+module Aven
+end

data/lib/tasks/annotate_rb.rake

@@ -0,0 +1,10 @@
+# This rake task was added by annotate_rb gem.
+
+# Can set `ANNOTATERB_SKIP_ON_DB_TASKS` to be anything to skip this
+is_dummy = Rails.application.class.module_parent_name == "Dummy"
+
+if Rails.env.development? && ENV["ANNOTATERB_SKIP_ON_DB_TASKS"].nil? && is_dummy
+  require "annotate_rb"
+
+  AnnotateRb::Core.load_rake_tasks
+end

data/lib/tasks/aven_tasks.rake

@@ -0,0 +1,21 @@
+# desc "Explaining what the task does"
+namespace :aven do
+  desc "run tailwind"
+  task :tailwind_engine_watch do
+    require "tailwindcss-rails"
+
+    command = [
+      Tailwindcss::Commands.compile_command.first,
+      "-i", Aven::Engine.root.join("app/assets/stylesheets/aven/application.tailwind.css").to_s,
+      "-o", Aven::Engine.root.join("app/assets/stylesheets/aven/tailwind.css").to_s,
+      "-w",
+      "--content", [
+        Aven::Engine.root.join("app/components/**/*.rb").to_s,
+        Aven::Engine.root.join("app/components/**/*.erb").to_s
+      ].join(",")
+    ]
+
+    p command
+    system(*command)
+  end
+end