anima-core 1.3.0 → 1.5.0

data/templates/config.toml

@@ -29,12 +29,19 @@ max_tool_rounds = 500
 
 # Context window budget — tokens reserved for conversation history.
 # Set this based on your model's context window minus system prompt.
-token_budget = 190_000
+token_budget = 120_000
 
 # Maximum character length for the Think tool's thoughts parameter.
 # Sub-agents receive half this budget (their tasks are less complex).
 thinking_budget = 10_000
 
+# Model for sub-agent sessions. Sonnet is cost-effective for focused tasks.
+subagent_model = "claude-sonnet-4-6"
+
+# Context window budget for sub-agent sessions.
+# Smaller than main to stay out of the "dumb zone" (~last 10% of context).
+subagent_token_budget = 90_000
+
 # ─── Timeouts (seconds) ─────────────────────────────────────────
 
 [timeouts]
@@ -95,16 +102,6 @@ max_tool_response_chars = 6_000
 # ~24000 chars ≈ ~8000 tokens.
 max_subagent_response_chars = 24_000
 
-# ─── Environment ──────────────────────────────────────────────
-
-[environment]
-
-# Files to scan for in the working directory (at root and up to project_files_max_depth subdirectories deep).
-project_files = ["CLAUDE.md", "AGENTS.md", "README.md", "CONTRIBUTING.md"]
-
-# Maximum directory depth for project file scanning.
-project_files_max_depth = 3
-
 # ─── GitHub ─────────────────────────────────────────────────────
 
 [github]
@@ -130,33 +127,16 @@ soul = "{{ANIMA_HOME}}/soul.md"
 # View mode for new sessions: "basic", "verbose", or "debug".
 default_view_mode = "basic"
 
-# Regenerate session name every N messages.
-name_generation_interval = 30
 
-# ─── Goals ──────────────────────────────────────────────────────
+# ─── Melete ─────────────────────────────────────────
 
-[goals]
+[melete]
 
-# Number of meaningful messages (user + agent turns) after completion
-# before a completed goal is automatically evicted from context.
-completed_decay_messages = 5
-
-# ─── Analytical Brain ─────────────────────────────────────────
-
-[analytical_brain]
-
-# Maximum tokens per analytical brain response.
+# Maximum tokens per Melete response.
 # Must accommodate multiple tool calls (rename + goals + skills + ready).
 max_tokens = 4096
 
-# Run the analytical brain synchronously before the main agent on user messages.
-# Ensures activated skills are available for the current response.
-blocking_on_user_message = true
-
-# Run the analytical brain asynchronously after the main agent completes.
-blocking_on_agent_message = false
-
-# Number of recent messages to include in the analytical brain's context window.
+# Number of recent messages to include in Melete's context window.
 message_window = 20
 
 # ─── Mneme (Memory Department) ──────────────────────────────────
@@ -181,6 +161,10 @@ l2_budget_fraction = 0.05
 # Number of uncovered Level 1 snapshots that triggers Level 2 compression.
 l2_snapshot_threshold = 5
 
+# Fraction of the viewport to evict in batch when Mneme runs.
+# Matches the viewport_fraction (Mneme's zone = eviction zone).
+eviction_fraction = 0.33
+
 # Fraction of the main viewport token budget reserved for pinned messages.
 # Pinned messages appear between snapshots and the sliding window in the Goals section.
 pinned_budget_fraction = 0.05

data/templates/tui.toml

@@ -0,0 +1,209 @@
+# TUI Configuration
+#
+# Presentation settings for the Anima terminal interface.
+# Changes take effect immediately — no restart needed.
+#
+# These settings only affect the TUI client, not the brain server.
+# Brain settings live in config.toml.
+
+# ─── Connection ──────────────────────────────────────────────────
+
+[connection]
+
+# Brain server address (host:port). Override per-launch with --host flag.
+default_host = "localhost:42134"
+
+# Seconds to wait for WebSocket thread cleanup on disconnect.
+disconnect_timeout = 2
+
+# Seconds between connection status checks during connect/reconnect.
+poll_interval = 0.1
+
+# Seconds before a connection attempt is considered timed out.
+timeout = 10
+
+# Maximum reconnection attempts before giving up.
+max_reconnect_attempts = 10
+
+# Initial delay before first reconnection attempt (seconds).
+# Doubles with each subsequent attempt up to backoff_cap.
+backoff_base = 1.0
+
+# Maximum delay between reconnection attempts (seconds).
+backoff_cap = 30.0
+
+# Seconds without an Action Cable ping before the connection is stale.
+ping_stale_threshold = 6.0
+
+# ─── HUD ─────────────────────────────────────────────────────────
+
+[hud]
+
+# Minimum width (columns) for the info panel.
+# The HUD occupies 1/3 of screen width, clamped to this minimum.
+min_width = 24
+
+# Lines scrolled per keyboard arrow event.
+scroll_step = 1
+
+# Lines scrolled per mouse wheel event.
+mouse_scroll_step = 2
+
+# ─── Chat ────────────────────────────────────────────────────────
+
+[chat]
+
+# Minimum height (rows) for the text input area.
+min_input_height = 3
+
+# Lines scrolled per keyboard arrow event.
+scroll_step = 1
+
+# Lines scrolled per mouse wheel event.
+mouse_scroll_step = 2
+
+# Entries rendered before scroll target for upward scroll margin.
+viewport_back_buffer = 3
+
+# Viewports worth of lines to pre-build for smooth scrolling.
+viewport_overflow_multiplier = 2
+
+# Entries from the end before including all trailing entries.
+viewport_bottom_threshold = 10
+
+# ─── Terminal ────────────────────────────────────────────────────
+
+[terminal]
+
+# How often the watchdog checks if the controlling terminal is alive (seconds).
+check_interval = 0.5
+
+# Grace period for watchdog thread to exit before force-killing it (seconds).
+shutdown_timeout = 1
+
+# ─── Token Dialog ────────────────────────────────────────────────
+
+[token_dialog]
+
+# Leading characters shown unmasked in the token input.
+# Default 14 matches the "sk-ant-oat01-" prefix plus one secret character.
+mask_visible = 14
+
+# Maximum stars shown in the masked portion.
+mask_stars = 4
+
+# Height (rows) of the token setup popup.
+popup_height = 14
+
+# Minimum width (columns) of the token setup popup.
+popup_min_width = 44
+
+# ─── Session Picker ──────────────────────────────────────────────
+
+[session_picker]
+
+# Sessions displayed per page.
+page_size = 9
+
+# Maximum sessions fetched from the brain for client-side pagination.
+fetch_limit = 50
+
+# ─── Flash ───────────────────────────────────────────────────────
+
+[flash]
+
+# Seconds before flash notifications auto-dismiss.
+auto_dismiss_seconds = 20.0
+
+# Flash area occupies at most 1/N of the chat pane height.
+max_height_fraction = 3
+
+# ─── Input ───────────────────────────────────────────────────────
+
+[input]
+
+# Maximum character length for the text input buffer.
+max_length = 10_000
+
+# ─── Message Store ───────────────────────────────────────────────
+
+[message_store]
+
+# Maximum cache history entries for sparkline rendering.
+# Each braille character encodes 2 data points, so 200 entries
+# render as ~100 characters.
+max_cache_history = 200
+
+# ─── Theme ────────────────────────────────────────────────────────
+
+[theme]
+
+# Progress bar width in characters.
+progress_bar_width = 8
+
+# Rate limit color thresholds (percentage).
+# Below warning = green, between warning and critical = yellow, above critical = red.
+rate_limit_warning = 70
+rate_limit_critical = 90
+
+# Cache hit color thresholds (percentage).
+# Above good = green, between low and good = yellow, below low = red.
+cache_hit_good = 70
+cache_hit_low = 30
+
+# Chat message background colors (256-color palette codes).
+# 22 = dark green (#005f00), 17 = dark navy (#00005f).
+# Full palette: https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit
+user_message_bg = 22
+assistant_message_bg = 17
+
+# Scrollbar colors.
+scrollbar_thumb = "cyan"
+scrollbar_track = "dark_gray"
+
+# Semantic colors — consistent visual language across the TUI.
+# Success (connected, completed, saved), error (disconnected, failed),
+# warning (connecting, loading, in-progress), info (labels, highlights),
+# muted (de-emphasized, idle, hints), accent (tool calls, special actions).
+color_success = "green"
+color_error = "red"
+color_warning = "yellow"
+color_info = "cyan"
+color_muted = "dark_gray"
+color_accent = "magenta"
+color_text = "white"
+
+# Selection highlight (session picker, menus).
+highlight_fg = "black"
+highlight_bg = "cyan"
+
+# Flash notification colors.
+flash_error_fg = "white"
+flash_error_bg = "red"
+flash_warning_fg = "black"
+flash_warning_bg = "yellow"
+flash_info_fg = "white"
+flash_info_bg = "blue"
+
+# Token count color for expensive responses (10k-20k tokens).
+# 208 = orange in 256-color palette.
+color_expensive = 208
+
+# Tool response CRUD colors — distinguish read/create/update at a glance.
+tool_read_color = "light_blue"
+tool_create_color = "light_green"
+tool_update_color = "light_yellow"
+
+# Border colors.
+border_focused = "yellow"
+border_normal = "white"
+border_input_connected = "green"
+border_input_connecting = "yellow"
+border_input_disconnected = "dark_gray"
+
+# ─── Performance ─────────────────────────────────────────────────
+
+[performance]
+
+# File path for TUI performance debug logs (relative to working directory).
+log_path = "log/tui_performance.log"

data/workflows/review_pr.md

@@ -124,37 +124,38 @@ Read the diff from: /tmp/pr_<number>_diff.txt
 - REST conventions and route design
 - ActiveRecord patterns (associations, validations placement)
 - Service object patterns and naming
+- Security-adjacent AR patterns: raw SQL interpolation, mass assignment gaps, missing tenant/org scoping on shared-model queries
 
 Output: List findings tagged [major], [minor], or [nit] with file:line references."
 ```
 
-#### Subagent 2: SecurityHawk
+#### Subagent 2: TicketDelivery
 
 ```
-Prompt: "Review PR #<number> for security vulnerabilities.
+Prompt: "Your role: verify this PR delivers the ticket. Code-quality subagents judge how the work was done; you judge whether the work was done.
 
 Read the diff from: /tmp/pr_<number>_diff.txt
 
-*Critical:* Activate the `activerecord` skill for SQL injection prevention patterns.
+The ticket defines 'done'. The PR description is how the author frames their work — useful context, not authority. When the two disagree, the ticket wins and the disagreement itself is a finding.
 
-## Ticket Context
-<ticket title, acceptance criteria, business context>
+## Ticket (verbatim — do not summarize)
+<full ticket title, description, every Task, every Acceptance Criterion>
+
+## PR description (verbatim)
+<PR body from Step 1>
 
 ## Historical Context
 <output from thoughts-analyzer>
 
 <any additional instructions from user input>
 
-## Focus Areas
-- SQL injection (raw queries, interpolation in where clauses)
-- XSS vulnerabilities (unescaped output, html_safe misuse)
-- CSRF protection gaps
-- Mass assignment vulnerabilities (permit params)
-- Authentication/authorization bypasses
-- Secrets or credentials in code
-- Insecure direct object references
+## How to work
 
-Output: List findings tagged [major], [minor], or [nit] with file:line references."
+Map each requirement in the ticket — Tasks, Acceptance Criteria, named targets — to evidence in the diff. For each, produce one line: ✅ delivered, ⚠️ partial, or ❌ missing, with file:line references.
+
+A requirement is delivered when the code does what the ticket asked for in meaning, not merely in mention. Match semantics against the ticket's verbs: 'add Y' needs Y; 'replace X with Y' needs Y and no X. When the ticket lists multiple targets, verify each separately.
+
+Output: the verification table first. Then findings tagged [major], [minor], or [nit] with file:line references."
 ```
 
 #### Subagent 3: PerfPro
@@ -182,6 +183,7 @@ Read the diff from: /tmp/pr_<number>_diff.txt
 - Memory bloat (loading large datasets)
 - Missing caching opportunities
 - Background job considerations (should this be async?)
+- Cross-tenant data leakage in aggregation (missing organization_id scope on joins, unscoped WHERE in reports)
 
 Output: List findings tagged [major], [minor], or [nit] with file:line references."
 ```
@@ -210,6 +212,7 @@ Read the diff from: /tmp/pr_<number>_diff.txt
 - Test isolation issues (shared state, missing cleanup)
 - Assertion quality (testing behavior vs implementation)
 - Missing edge case coverage
+- Missing coverage for authorization boundaries (cross-org access denial, role-based access denied, unauthenticated request rejected)
 
 Output: List findings tagged [major], [minor], or [nit] with file:line references."
 ```
@@ -235,6 +238,7 @@ Read the diff from: /tmp/pr_<number>_diff.txt
 - Complex logic lacking explanatory comments
 - Misleading or outdated comments
 - Magic numbers or strings needing constants
+- Secrets, tokens, or credentials appearing in logs, comments, error messages, or test fixtures; permission-gating magic constants that should be named
 
 Output: List findings tagged [major], [minor], or [nit] with file:line references."
 ```

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: anima-core
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Yevhenii Hurin
@@ -9,6 +9,20 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: aasm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.5'
 - !ruby/object:Gem::Dependency
   name: certifi
   requirement: !ruby/object:Gem::Requirement
@@ -260,20 +274,31 @@ files:
 - app/decorators/agent_message_decorator.rb
 - app/decorators/application_decorator.rb
 - app/decorators/message_decorator.rb
+- app/decorators/pending_from_melete_decorator.rb
+- app/decorators/pending_from_melete_goal_decorator.rb
+- app/decorators/pending_from_melete_skill_decorator.rb
+- app/decorators/pending_from_melete_workflow_decorator.rb
+- app/decorators/pending_from_mneme_decorator.rb
+- app/decorators/pending_message_decorator.rb
+- app/decorators/pending_subagent_decorator.rb
+- app/decorators/pending_tool_response_decorator.rb
+- app/decorators/pending_user_message_decorator.rb
 - app/decorators/system_message_decorator.rb
 - app/decorators/tool_call_decorator.rb
 - app/decorators/tool_decorator.rb
 - app/decorators/tool_response_decorator.rb
 - app/decorators/user_message_decorator.rb
 - app/decorators/web_get_tool_decorator.rb
-- app/jobs/agent_request_job.rb
-- app/jobs/analytical_brain_job.rb
 - app/jobs/application_job.rb
-- app/jobs/count_message_tokens_job.rb
+- app/jobs/count_tokens_job.rb
+- app/jobs/drain_job.rb
+- app/jobs/melete_enrichment_job.rb
+- app/jobs/melete_enrichment_job/goal_change_listener.rb
+- app/jobs/mneme_enrichment_job.rb
 - app/jobs/mneme_job.rb
-- app/jobs/passive_recall_job.rb
+- app/jobs/tool_execution_job.rb
 - app/models/application_record.rb
-- app/models/concerns/message/broadcasting.rb
+- app/models/concerns/token_estimation.rb
 - app/models/goal.rb
 - app/models/goal_pinned_message.rb
 - app/models/message.rb
@@ -282,9 +307,12 @@ files:
 - app/models/secret.rb
 - app/models/session.rb
 - app/models/snapshot.rb
+- bin/inspect-cassette
 - bin/jobs
 - bin/rails
 - bin/rake
+- bin/release
+- bin/with-llms
 - config.ru
 - config/application.rb
 - config/boot.rb
@@ -295,7 +323,6 @@ files:
 - config/environments/production.rb
 - config/environments/test.rb
 - config/initializers/event_subscribers.rb
-- config/initializers/fts5_schema_dump.rb
 - config/initializers/inflections.rb
 - config/initializers/time_nanoseconds.rb
 - config/puma.rb
@@ -303,6 +330,7 @@ files:
 - config/recurring.yml
 - config/routes.rb
 - db/cable_schema.rb
+- db/cable_structure.sql
 - db/migrate/.keep
 - db/migrate/20260308124202_create_sessions.rb
 - db/migrate/20260308124203_create_events.rb
@@ -330,24 +358,27 @@ files:
 - db/migrate/20260328100000_create_secrets.rb
 - db/migrate/20260328152142_add_evicted_at_to_goals.rb
 - db/migrate/20260329120000_create_pending_messages.rb
+- db/migrate/20260330120000_add_source_to_pending_messages.rb
+- db/migrate/20260401180000_add_api_metrics_to_messages.rb
+- db/migrate/20260401210935_remove_recalled_message_ids_from_sessions.rb
+- db/migrate/20260403080031_add_initial_cwd_to_sessions.rb
+- db/migrate/20260407170803_remove_viewport_message_ids_from_sessions.rb
+- db/migrate/20260407180400_remove_mneme_snapshot_pointer_columns_from_sessions.rb
+- db/migrate/20260411120553_add_token_count_to_pinned_messages.rb
+- db/migrate/20260411172926_remove_active_skills_and_workflow_from_sessions.rb
+- db/migrate/20260412110625_replace_processing_with_aasm_state.rb
+- db/migrate/20260418150323_add_kind_and_message_type_to_pending_messages.rb
+- db/migrate/20260419120000_add_drain_fields_to_pending_messages.rb
+- db/migrate/20260419130000_drop_pending_messages_kind_default.rb
+- db/migrate/20260419140000_add_drain_indexes_to_pending_messages.rb
+- db/migrate/20260420100000_add_hud_visibility_to_sessions.rb
 - db/queue_schema.rb
+- db/queue_structure.sql
 - db/seeds.rb
+- db/structure.sql
 - exe/anima
-- lib/agent_loop.rb
 - lib/agents/definition.rb
 - lib/agents/registry.rb
-- lib/analytical_brain.rb
-- lib/analytical_brain/runner.rb
-- lib/analytical_brain/tools/activate_skill.rb
-- lib/analytical_brain/tools/assign_nickname.rb
-- lib/analytical_brain/tools/deactivate_skill.rb
-- lib/analytical_brain/tools/deactivate_workflow.rb
-- lib/analytical_brain/tools/everything_is_ready.rb
-- lib/analytical_brain/tools/finish_goal.rb
-- lib/analytical_brain/tools/read_workflow.rb
-- lib/analytical_brain/tools/rename_session.rb
-- lib/analytical_brain/tools/set_goal.rb
-- lib/analytical_brain/tools/update_goal.rb
 - lib/anima.rb
 - lib/anima/cli.rb
 - lib/anima/cli/mcp.rb
@@ -358,35 +389,70 @@ files:
 - lib/anima/spinner.rb
 - lib/anima/version.rb
 - lib/credential_store.rb
-- lib/environment_probe.rb
-- lib/events/agent_message.rb
+- lib/events/authentication_required.rb
 - lib/events/base.rb
 - lib/events/bounce_back.rb
 - lib/events/bus.rb
+- lib/events/eviction_completed.rb
+- lib/events/goal_created.rb
+- lib/events/goal_updated.rb
+- lib/events/llm_responded.rb
+- lib/events/message_created.rb
+- lib/events/message_updated.rb
+- lib/events/session_state_changed.rb
+- lib/events/skill_activated.rb
+- lib/events/start_melete.rb
+- lib/events/start_mneme.rb
+- lib/events/start_processing.rb
+- lib/events/subagent_evicted.rb
 - lib/events/subscriber.rb
-- lib/events/subscribers/message_collector.rb
+- lib/events/subscribers/active_state_broadcaster.rb
+- lib/events/subscribers/authentication_broadcaster.rb
+- lib/events/subscribers/drain_kickoff.rb
+- lib/events/subscribers/eviction_broadcaster.rb
+- lib/events/subscribers/llm_response_handler.rb
+- lib/events/subscribers/melete_kickoff.rb
+- lib/events/subscribers/message_broadcaster.rb
+- lib/events/subscribers/mneme_kickoff.rb
+- lib/events/subscribers/mneme_scheduler.rb
 - lib/events/subscribers/persister.rb
+- lib/events/subscribers/session_state_broadcaster.rb
 - lib/events/subscribers/subagent_message_router.rb
+- lib/events/subscribers/subagent_visibility_broadcaster.rb
+- lib/events/subscribers/tool_response_creator.rb
 - lib/events/subscribers/transient_broadcaster.rb
 - lib/events/system_message.rb
-- lib/events/tool_call.rb
-- lib/events/tool_response.rb
+- lib/events/tool_executed.rb
 - lib/events/user_message.rb
+- lib/events/workflow_activated.rb
 - lib/llm/client.rb
 - lib/mcp/client_manager.rb
 - lib/mcp/config.rb
 - lib/mcp/health_check.rb
 - lib/mcp/secrets.rb
 - lib/mcp/stdio_transport.rb
+- lib/melete.rb
+- lib/melete/runner.rb
+- lib/melete/tools/activate_skill.rb
+- lib/melete/tools/assign_nickname.rb
+- lib/melete/tools/everything_is_ready.rb
+- lib/melete/tools/finish_goal.rb
+- lib/melete/tools/goal_messaging.rb
+- lib/melete/tools/read_workflow.rb
+- lib/melete/tools/rename_session.rb
+- lib/melete/tools/set_goal.rb
+- lib/melete/tools/update_goal.rb
 - lib/mneme.rb
-- lib/mneme/compressed_viewport.rb
+- lib/mneme/base_runner.rb
 - lib/mneme/l2_runner.rb
-- lib/mneme/passive_recall.rb
+- lib/mneme/recall_runner.rb
 - lib/mneme/runner.rb
 - lib/mneme/search.rb
 - lib/mneme/tools/attach_messages_to_goals.rb
 - lib/mneme/tools/everything_ok.rb
+- lib/mneme/tools/nothing_to_surface.rb
 - lib/mneme/tools/save_snapshot.rb
+- lib/mneme/tools/surface_memory.rb
 - lib/providers/anthropic.rb
 - lib/shell_session.rb
 - lib/skills/definition.rb
@@ -399,14 +465,14 @@ files:
 - lib/tools/mcp_tool.rb
 - lib/tools/open_issue.rb
 - lib/tools/read.rb
-- lib/tools/recall.rb
 - lib/tools/registry.rb
-- lib/tools/remember.rb
 - lib/tools/response_truncator.rb
+- lib/tools/search_messages.rb
 - lib/tools/spawn_specialist.rb
 - lib/tools/spawn_subagent.rb
 - lib/tools/subagent_prompts.rb
 - lib/tools/think.rb
+- lib/tools/view_messages.rb
 - lib/tools/web_get.rb
 - lib/tools/write.rb
 - lib/tui/app.rb
@@ -426,6 +492,7 @@ files:
 - lib/tui/message_store.rb
 - lib/tui/performance_logger.rb
 - lib/tui/screens/chat.rb
+- lib/tui/settings.rb
 - lib/workflows/definition.rb
 - lib/workflows/registry.rb
 - skills/activerecord/SKILL.md
@@ -530,6 +597,7 @@ files:
 - skills/draper-decorators/references/patterns.md
 - skills/draper-decorators/references/testing.md
 - skills/gh-issue.md
+- skills/github.md
 - skills/mcp-server/SKILL.md
 - skills/mcp-server/examples/dynamic_tools.rb
 - skills/mcp-server/examples/file_manager_tool.rb
@@ -609,6 +677,7 @@ files:
 - skills/rspec/references/rails.md
 - templates/config.toml
 - templates/soul.md
+- templates/tui.toml
 - workflows/commit.md
 - workflows/create_handoff.md
 - workflows/create_note.md