agentboard 0.2.0

data/lib/agentboard.rb

@@ -0,0 +1,73 @@
+require "securerandom"
+require "digest"
+require "json"
+require "yaml"
+require "pathname"
+require "set"
+require "active_support"
+require "active_support/core_ext/object/blank"
+require "active_support/core_ext/string"
+
+require "agentboard/version"
+require "agentboard/errors"
+require "agentboard/result"
+require "agentboard/ids"
+require "agentboard/redactor"
+require "agentboard/extensions"
+require "agentboard/command_policy"
+require "agentboard/process_ancestry"
+require "agentboard/json_log_formatter"
+require "agentboard/container_sandbox"
+require "agentboard/agent_container"
+require "agentboard/egress_proxy"
+require "agentboard/event_schema"
+require "agentboard/configuration"
+require "agentboard/state_machines"
+require "agentboard/authorization"
+require "agentboard/providers"
+require "agentboard/git"
+require "agentboard/verification"
+require "agentboard/workflows"
+require "agentboard/rails_introspection"
+require "agentboard/context_builder"
+require "agentboard/capture"
+require "agentboard/runtime"
+require "agentboard/engine" if defined?(Rails::Engine)
+
+# AgentBoard: local-first, AI-native development management and orchestration.
+#
+# The Rails Engine (UI, API, persistence) and the runtime daemon (agent processes)
+# are separate OS processes. Everything under lib/ is framework-independent unless
+# it explicitly requires Active Record models from app/.
+module Agentboard
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+    alias_method :config, :configuration
+
+    def configure
+      yield configuration
+    end
+
+    def reset_configuration!
+      @configuration = nil
+    end
+
+    # Third-party adapter registration (spec §5):
+    #   Agentboard.register_provider(:custom_agent, adapter: MyCustomAgentAdapter)
+    def register_provider(key, adapter:)
+      Providers.registry.register(key, adapter)
+    end
+
+    def logger
+      @logger ||= if defined?(Rails) && Rails.respond_to?(:logger) && Rails.logger
+        Rails.logger
+      else
+        require "logger"
+        Logger.new($stderr, level: Logger::INFO)
+      end
+    end
+    attr_writer :logger
+  end
+end

data/lib/generators/agentboard/install/install_generator.rb

@@ -0,0 +1,67 @@
+require "rails/generators"
+require "rails/generators/active_record"
+
+module Agentboard
+  module Generators
+    # bin/rails generate agentboard:install
+    # Idempotent: never overwrites existing files unless --force (Thor shows a diff/conflict prompt otherwise).
+    class InstallGenerator < Rails::Generators::Base
+      include ActiveRecord::Generators::Migration
+      source_root File.expand_path("templates", __dir__)
+
+      def copy_initializer
+        template "initializer.rb", "config/initializers/agentboard.rb"
+      end
+
+      def copy_config
+        template "config.yml", "config/agentboard.yml"
+      end
+
+      def create_local_dirs
+        %w[workflows instructions policies cache].each { |d| empty_directory ".agentboard/#{d}" }
+        copy_file "feature_delivery.yml", ".agentboard/workflows/feature_delivery.yml"
+      end
+
+      def copy_migrations
+        rake "agentboard:install:migrations"
+      end
+
+      def mount_engine
+        routes = File.join(destination_root, "config/routes.rb")
+        return if File.exist?(routes) && File.read(routes).include?("Agentboard::Engine")
+
+        route "# AgentBoard dashboard: development only by default\nif Rails.env.development?\n  mount Agentboard::Engine, at: \"/agentboard\"\nend"
+      end
+
+      def ignore_local_state
+        path = File.join(destination_root, ".gitignore")
+        entries = [ "/.agentboard/worktrees/", "/.agentboard/logs/", "/.agentboard/cache/", "/.agentboard/spool/", "/.agentboard/manifests/", "*.agentboard-backup-*" ]
+        existing = File.exist?(path) ? File.read(path).lines.map(&:strip) : []
+        missing = entries - existing
+        return if missing.empty?
+
+        block = "\n# AgentBoard local state\n#{missing.join("\n")}\n"
+        File.exist?(path) ? append_to_file(".gitignore", block) : create_file(".gitignore", block.lstrip)
+      end
+
+      def write_manifest
+        create_file ".agentboard/generated_manifest.json", JSON.pretty_generate(
+          "generator" => "agentboard:install", "version" => Agentboard::VERSION,
+          "files" => %w[config/initializers/agentboard.rb config/agentboard.yml .agentboard/workflows/feature_delivery.yml]
+        ) + "\n"
+      end
+
+      def show_next_steps
+        say <<~TEXT
+
+          AgentBoard installed. Next:
+            bin/rails db:migrate
+            bundle exec agentboard doctor
+            bundle exec agentboard provider setup claude   # and/or codex
+            bundle exec agentboard daemon start
+            open http://localhost:3000/agentboard
+        TEXT
+      end
+    end
+  end
+end

data/lib/generators/agentboard/install/templates/config.yml

@@ -0,0 +1,81 @@
+# AgentBoard configuration — desired behaviour. Actual provider capabilities are detected.
+project:
+  name: # defaults to the repository directory name
+  key:  # ticket prefix, e.g. AB (defaults to initials of the name)
+
+runtime:
+  mode: local
+  max_concurrent_executions: 1
+  workspace: .agentboard/worktrees
+  execution_timeout_seconds: 3600
+  cancel_grace_seconds: 5
+
+providers:
+  claude: { enabled: true, passive: true, active: true }
+  codex: { enabled: true, passive: true, active: true }
+  cursor: { enabled: false, passive: true, active: false }
+  fake: { enabled: true, passive: true, active: true }
+
+security:
+  require_review: true
+  allow_production_commands: false
+  # Agents run as your OS user; Git worktrees are NOT sandboxes. Real providers (claude,
+  # codex) only run in active mode once you explicitly trust local execution:
+  trusted_local_execution: false
+  sandbox: none        # container: run verification (and, with sandbox.agents, agents) in Docker
+
+# Container isolation (security.sandbox: container). `agentboard sandbox init && agentboard sandbox build`
+# sandbox:
+#   runtime: docker
+#   image: agentboard-agent:<project>        # verification commands, --network none
+#   agents: true                             # also run agents in containers
+#   agent_image: agentboard-agent:<project>  # internal network + egress allowlist proxy
+#   egress_allow: []                         # extra host:port pairs beyond provider APIs
+#   credential_env: [ANTHROPIC_API_KEY, OPENAI_API_KEY]   # forwarded by name only
+#   claude_config_dir: ~/.agentboard-sandbox/claude       # dedicated (not your personal) login
+
+completion:
+  require_criteria_verified: true
+  require_checks: true
+  require_approval: true
+  # when_linked: tickets with an open/merged PR need that PR merged on the reviewed head;
+  # tickets without a PR complete on criteria + checks + approval. Also: always | never.
+  require_merged_pr: when_linked
+
+# Approved command catalog. Workflows and agents reference these by name; argv is executed
+# directly (no shell). Results are bound to the exact commit they ran against.
+verification_commands:
+  rails_test:
+    argv: ["bin/rails", "test"]
+    timeout_seconds: 900
+    required: true
+  rubocop:
+    argv: ["bin/rubocop"]
+    timeout_seconds: 600
+    required: false
+
+# In-app capture widget (Alt+Shift+A on any page). Development is free; other environments
+# (e.g. staging for QA) and screenshots need AgentBoard Pro (feature: capture).
+capture:
+  enabled: true
+  environments: [development]
+
+retention:
+  raw_log_days: 30
+  worktree_days: 7
+  provider_output_event_days: 30
+
+# Git hosting (AgentBoard Pro, feature git_hosting). Point a webhook for pull/merge
+# requests at /agentboard/webhooks/<github|gitlab|bitbucket> and export the secret in the
+# variable named below. Without a secret the endpoint does not exist.
+git_hosts:
+  default:            # github | gitlab | bitbucket — detected from `origin` when empty
+  github:
+    secret_env: AGENTBOARD_GITHUB_WEBHOOK_SECRET    # HMAC (X-Hub-Signature-256)
+  gitlab:
+    secret_env: AGENTBOARD_GITLAB_WEBHOOK_TOKEN     # X-Gitlab-Token
+    base_url: https://gitlab.com
+    token_env: GITLAB_TOKEN                         # for opening merge requests
+  bitbucket:
+    secret_env: AGENTBOARD_BITBUCKET_WEBHOOK_SECRET # HMAC (X-Hub-Signature)
+    token_env: BITBUCKET_TOKEN                      # repository access token

data/lib/generators/agentboard/install/templates/feature_delivery.yml

@@ -0,0 +1,25 @@
+version: 1
+name: feature_delivery
+steps:
+  - id: plan
+    type: agent
+    provider: claude
+    action: plan
+  - id: implement
+    type: agent
+    provider: codex
+    action: implement
+    depends_on: [plan]
+    # AgentBoard Pro adds: retry, timeout_seconds, condition, external and git_pull_request steps.
+  - id: test
+    type: command
+    command: rails_test
+    depends_on: [implement]
+  - id: review
+    type: agent
+    provider: claude
+    action: review
+    depends_on: [test]
+  - id: approval
+    type: human_approval
+    depends_on: [review]

data/lib/generators/agentboard/install/templates/initializer.rb

@@ -0,0 +1,23 @@
+# AgentBoard is usually bundled in the :development group only, so this file must be a no-op
+# in environments (test, production) where the gem is not loaded.
+return unless defined?(Agentboard::Engine)
+
+# AgentBoard configuration. YAML in config/agentboard.yml and .agentboard/config.yml is
+# loaded first; anything set here takes precedence.
+Agentboard.configure do |config|
+  # Reuse your app's authentication for the dashboard (return an actor or nil):
+  #
+  # config.authenticate_with = ->(controller) do
+  #   user = controller.send(:current_user) or next nil
+  #   Agentboard::Authorization::Actor.new(type: "human", id: user.id.to_s, name: user.email, role: user.admin? ? "administrator" : "developer")
+  # end
+  #
+  # Without an adapter the dashboard only accepts local requests. Optionally require a token:
+  # config.dashboard_token = ENV["AGENTBOARD_DASHBOARD_TOKEN"]
+  #
+  # Extra secret patterns to redact from logs, events and exports:
+  # config.redaction_patterns = [/acme_live_[A-Za-z0-9]{24}/]
+end
+
+# Third-party provider adapters:
+# Agentboard.register_provider(:custom_agent, adapter: MyCustomAgentAdapter)

data/lib/tasks/agentboard_tasks.rake

@@ -0,0 +1,6 @@
+namespace :agentboard do
+  desc "Drain the event outbox once"
+  task drain_outbox: :environment do
+    puts "delivered #{Agentboard::Outbox.drain(limit: 1000)}"
+  end
+end

metadata

@@ -0,0 +1,285 @@
+--- !ruby/object:Gem::Specification
+name: agentboard
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- PIRUBY
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: turbo-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: stimulus-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.25'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.25'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.3'
+description: |
+  AgentBoard installs into a Rails application and connects tickets to coding agents
+  (Claude Code, OpenAI Codex, Cursor and third-party adapters) through MCP, provider hooks,
+  a supervised runtime daemon, isolated Git worktrees and evidence-based completion policies.
+executables:
+- agentboard
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/stylesheets/agentboard/application.css
+- app/controllers/agentboard/agents_controller.rb
+- app/controllers/agentboard/analytics_controller.rb
+- app/controllers/agentboard/application_controller.rb
+- app/controllers/agentboard/approvals_controller.rb
+- app/controllers/agentboard/assets_controller.rb
+- app/controllers/agentboard/board_controller.rb
+- app/controllers/agentboard/captures_controller.rb
+- app/controllers/agentboard/comments_controller.rb
+- app/controllers/agentboard/criteria_controller.rb
+- app/controllers/agentboard/dependencies_controller.rb
+- app/controllers/agentboard/executions_controller.rb
+- app/controllers/agentboard/milestones_controller.rb
+- app/controllers/agentboard/pulse_controller.rb
+- app/controllers/agentboard/sessions_controller.rb
+- app/controllers/agentboard/settings_controller.rb
+- app/controllers/agentboard/tickets_controller.rb
+- app/controllers/agentboard/workflow_runs_controller.rb
+- app/controllers/agentboard/workflows_controller.rb
+- app/helpers/agentboard/application_helper.rb
+- app/javascript/agentboard/application.js
+- app/javascript/agentboard/capture.js
+- app/jobs/agentboard/application_job.rb
+- app/models/agentboard/acceptance_criterion.rb
+- app/models/agentboard/agent_profile.rb
+- app/models/agentboard/agent_session.rb
+- app/models/agentboard/application_record.rb
+- app/models/agentboard/approval.rb
+- app/models/agentboard/artifact.rb
+- app/models/agentboard/comment.rb
+- app/models/agentboard/event.rb
+- app/models/agentboard/execution.rb
+- app/models/agentboard/idempotency_key.rb
+- app/models/agentboard/milestone.rb
+- app/models/agentboard/outbox_message.rb
+- app/models/agentboard/project.rb
+- app/models/agentboard/repository_snapshot.rb
+- app/models/agentboard/session_ticket_link.rb
+- app/models/agentboard/ticket.rb
+- app/models/agentboard/ticket_dependency.rb
+- app/models/agentboard/ticket_lease.rb
+- app/models/agentboard/usage_record.rb
+- app/models/agentboard/verification_result.rb
+- app/models/agentboard/webhook_delivery.rb
+- app/models/agentboard/workflow_definition.rb
+- app/models/agentboard/workflow_run.rb
+- app/models/agentboard/workflow_step.rb
+- app/services/agentboard/approvals.rb
+- app/services/agentboard/captures.rb
+- app/services/agentboard/completion_policy.rb
+- app/services/agentboard/current.rb
+- app/services/agentboard/data_governance.rb
+- app/services/agentboard/doctor.rb
+- app/services/agentboard/event_store.rb
+- app/services/agentboard/evidence.rb
+- app/services/agentboard/executions.rb
+- app/services/agentboard/hook_ingestion.rb
+- app/services/agentboard/idempotency.rb
+- app/services/agentboard/lease_service.rb
+- app/services/agentboard/mcp_server.rb
+- app/services/agentboard/mcp_tools.rb
+- app/services/agentboard/outbox.rb
+- app/services/agentboard/pull_requests.rb
+- app/services/agentboard/runtime/execution_runner.rb
+- app/services/agentboard/runtime/ipc_handler.rb
+- app/services/agentboard/runtime/reconciler.rb
+- app/services/agentboard/runtime/supervisor.rb
+- app/services/agentboard/session_association.rb
+- app/services/agentboard/session_correlation.rb
+- app/services/agentboard/session_credential.rb
+- app/services/agentboard/ticket_advisor.rb
+- app/services/agentboard/tickets.rb
+- app/services/agentboard/verification_service.rb
+- app/services/agentboard/workflow_engine.rb
+- app/views/agentboard/agents/index.html.erb
+- app/views/agentboard/analytics/show.html.erb
+- app/views/agentboard/approvals/_approval.html.erb
+- app/views/agentboard/approvals/index.html.erb
+- app/views/agentboard/board/_card.html.erb
+- app/views/agentboard/board/show.html.erb
+- app/views/agentboard/executions/index.html.erb
+- app/views/agentboard/executions/show.html.erb
+- app/views/agentboard/milestones/index.html.erb
+- app/views/agentboard/settings/show.html.erb
+- app/views/agentboard/shared/_dag.html.erb
+- app/views/agentboard/tickets/_form.html.erb
+- app/views/agentboard/tickets/edit.html.erb
+- app/views/agentboard/tickets/index.html.erb
+- app/views/agentboard/tickets/new.html.erb
+- app/views/agentboard/tickets/show.html.erb
+- app/views/agentboard/tickets/suggestions.html.erb
+- app/views/agentboard/workflow_runs/show.html.erb
+- app/views/agentboard/workflows/index.html.erb
+- app/views/agentboard/workflows/show.html.erb
+- app/views/layouts/agentboard/application.html.erb
+- config/routes.rb
+- db/migrate/20261114000001_create_agentboard_core.rb
+- db/migrate/20261114000002_create_agentboard_runtime.rb
+- db/migrate/20261115000001_create_agentboard_webhook_deliveries.rb
+- exe/agentboard
+- lib/agentboard.rb
+- lib/agentboard/agent_container.rb
+- lib/agentboard/authorization.rb
+- lib/agentboard/capture.rb
+- lib/agentboard/capture/middleware.rb
+- lib/agentboard/cli.rb
+- lib/agentboard/command_policy.rb
+- lib/agentboard/configuration.rb
+- lib/agentboard/container_sandbox.rb
+- lib/agentboard/context_builder.rb
+- lib/agentboard/egress_proxy.rb
+- lib/agentboard/engine.rb
+- lib/agentboard/errors.rb
+- lib/agentboard/event_schema.rb
+- lib/agentboard/extensions.rb
+- lib/agentboard/git.rb
+- lib/agentboard/git/repository.rb
+- lib/agentboard/git/worktree_manager.rb
+- lib/agentboard/ids.rb
+- lib/agentboard/json_log_formatter.rb
+- lib/agentboard/path_guard.rb
+- lib/agentboard/process_ancestry.rb
+- lib/agentboard/providers.rb
+- lib/agentboard/providers/base.rb
+- lib/agentboard/providers/claude_code.rb
+- lib/agentboard/providers/codex.rb
+- lib/agentboard/providers/compatibility/claude.yml
+- lib/agentboard/providers/compatibility/codex.yml
+- lib/agentboard/providers/config_editor.rb
+- lib/agentboard/providers/cursor.rb
+- lib/agentboard/providers/fake.rb
+- lib/agentboard/providers/fake_agent_script.rb
+- lib/agentboard/providers/generic_cli.rb
+- lib/agentboard/providers/registry.rb
+- lib/agentboard/providers/types.rb
+- lib/agentboard/rails_introspection.rb
+- lib/agentboard/redactor.rb
+- lib/agentboard/result.rb
+- lib/agentboard/runtime.rb
+- lib/agentboard/runtime/ipc.rb
+- lib/agentboard/state_machines.rb
+- lib/agentboard/subprocess.rb
+- lib/agentboard/templates/Dockerfile.agent
+- lib/agentboard/verification.rb
+- lib/agentboard/version.rb
+- lib/agentboard/workflows.rb
+- lib/agentboard/workflows/condition.rb
+- lib/agentboard/workflows/definition.rb
+- lib/generators/agentboard/install/install_generator.rb
+- lib/generators/agentboard/install/templates/config.yml
+- lib/generators/agentboard/install/templates/feature_delivery.yml
+- lib/generators/agentboard/install/templates/initializer.rb
+- lib/tasks/agentboard_tasks.rake
+homepage: https://agent-board.live
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://agent-board.live
+  documentation_uri: https://agent-board.live/docs
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: Local-first, AI-native ticket board and agent orchestration engine for Rails.
+test_files: []