aia 1.1.1 → 2.0.0.0.pre.alpha

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c8f6a82b1c6cc29b4245e51ed43a325a835a921a0da5c2818dbdfbdeeeb97c40
-  data.tar.gz: ff0cff98ed30d391970a11a44519cb9ea95082bfae2a08e5ebf03b71eeefac15
+  metadata.gz: fa3398e1c7d65c30234833e49a9319b6e49b9febcd97d13c3ba3aa4da7043c80
+  data.tar.gz: dbfad1a98f1c48452bfd7006b61c1d1384a108bdd0a6e81fc0308e4d21f3a917
 SHA512:
-  metadata.gz: ec35e9ae94d6c74ad6ecf87ad6a8511de29407d1bac99db1ff1266b7072ac078746bf9fcabb45f6aeed1858198b318ff2906e8858b74185de8107cfdcf48bfca
-  data.tar.gz: 7ee21fda6bdf851e2418d739450f2b8d6ffd8580e5aaaef7b84e5c16c83ded0eefb83e6c8a943ffa5bbe09960463eb8617c44adf9a66f6ad87b460edc50ed6b7
+  metadata.gz: 8147c86f02e631253a5eedc5e1f1469ac5631bcc998ffcdeb27dc435e018f86dacd2cfb97af3d2b7ce633924aa6ae9d8c69c834fbfe35458713a29e7dfc21e48
+  data.tar.gz: 68b51a79936852cafc714a9c540cb9b2b0fc016efb9fa88351a29b021c56ecefb6cbf31dacd4decab64467815cccccb8eccda4dcac18cf5700270d4af5c21948

data/.envrc

@@ -1,6 +1,9 @@
 source_up
 
-export RR=`pwd`
+export RR=$(pwd)
+
+export AIA_PLUGINS_DIR=$RR/plugins
+
 # PATH_add $RR/bin
 
 # see aia --help for --model option
@@ -9,3 +12,4 @@ export RR=`pwd`
 #   Use a comma to seperate the models in a multi-model setup
 #
 # export AIA_MODEL=claude-haiku-4-5,gpt-4o-mini
+export AIA_MODEL=ollama/qwen3.6

data/.loki

@@ -0,0 +1,231 @@
+# frozen_string_literal: true
+# aia/.loki — asgard task runner for the aia gem
+
+class Tasks
+  @@rr ||= Dir.pwd.freeze
+
+  header "aia — AI Assistant CLI gem"
+  footer "Run `asgard help TASK` for details on any task"
+
+  map "t"   => :test
+  map "i"   => :install
+  map "inc" => :bump
+
+  default_task :list
+
+  # ── Terminal utilities ─────────────────────────────────────────────────────
+
+  desc "Fix half-duplex terminal"
+  def fix = sh "stty sane"
+
+  desc "Clear the scroll-back buffer"
+  def clear_buffer = sh 'printf "\e[3J"'
+
+  # ── Mods ──────────────────────────────────────────────────────────────────
+
+  desc "Delete all mods saved conversations"
+  def mods_delete_all
+    sh "mods -l | awk '{print $1}' | xargs -I {} mods -d {}"
+  end
+
+  # ── Run ───────────────────────────────────────────────────────────────────
+
+  desc "aia [ARGS]", "Run the aia CLI with pass-through arguments (e.g. asgard aia --chat)"
+  def aia(*args)
+    sh "#{@@rr}/bin/aia #{args.join(' ')}"
+  end
+
+  # ── Tests & Quality ────────────────────────────────────────────────────────
+
+  desc "Run unit tests"
+  def test = sh "bundle exec rake test"
+
+  depends_on :test
+  desc "Open coverage report in browser (depends on: test)"
+  def coverage = sh "open #{@@rr}/coverage/index.html"
+
+  desc "Check code complexity with Flog"
+  def flog = sh "bundle exec rake flog_check > flog_output.txt 2>&1"
+
+  desc "Check for structural duplication with Flay"
+  def flay = sh "bundle exec rake flay_check > flay_output.txt 2>&1"
+
+  desc "Check code smells with Reek (fails only on new or worsened files)"
+  def reek
+    current  = reek_scan
+    baseline = load_reek_baseline
+
+    new_files = current.reject { |f, _| baseline.key?(f) }
+    worsened  = current.select { |f, c| baseline.key?(f) && c > baseline[f] }
+    improved  = baseline.count { |f, c| current.key?(f) && current[f] < c }
+    cleaned   = baseline.keys - current.keys
+
+    total_current  = current.values.sum
+    total_baseline = baseline.values.sum
+
+    puts "\nReek: #{total_current} warning(s) across #{current.size} file(s) " \
+         "(#{total_baseline} grandfathered across #{baseline.size} file(s))."
+    puts "  #{cleaned.size} file(s) fully clean — run `asgard reek_baseline` to prune." unless cleaned.empty?
+    puts "  #{improved} file(s) improved — run `asgard reek_baseline` to ratchet down." unless improved.zero?
+
+    problems = new_files.map { |f, c| format("NEW      %3d warning(s): %s", c, f) } +
+               worsened.map  { |f, c| format("WORSENED %3d -> %3d: %s", baseline[f], c, f) }
+
+    if problems.empty?
+      puts "Reek quality gate passed (no new or worsened files)."
+    else
+      puts "\nReek quality gate FAILED:"
+      problems.each { |p| puts "  #{p}" }
+      abort "\nReek: #{problems.size} file(s) regressed. Fix smells, or `asgard reek_baseline` if intentional."
+    end
+  end
+
+  desc "Regenerate the Reek baseline (grandfathers current smell counts per file)"
+  def reek_baseline
+    require 'fileutils'
+    FileUtils.mkdir_p('.quality')
+    warnings = reek_scan
+    body = warnings.sort_by { |f, _| f }.map { |f, c| "#{c}\t#{f}" }.join("\n")
+    File.write('.quality/reek_baseline.txt', body.empty? ? '' : "#{body}\n")
+    puts "Wrote #{warnings.size} file(s) with smells to .quality/reek_baseline.txt"
+  end
+
+  desc "Check code style with RuboCop"
+  def rubocop = sh "bundle exec rubocop > rubocop_output.txt 2>&1"
+
+  desc "Auto-correct RuboCop offenses"
+  def rubocop_fix = sh "bundle exec rubocop -a"
+
+  desc "Run all quality gates: tests + Flog + Flay + Reek + RuboCop"
+  def quality
+    gates = {
+      test:    -> { system("bundle exec rake test") },
+      flog:    -> { system("bundle exec rake flog_check   > flog_output.txt 2>&1") },
+      flay:    -> { system("bundle exec rake flay_check   > flay_output.txt 2>&1") },
+      reek:    -> { reek_gate },
+      rubocop: -> { system("bundle exec rubocop           > rubocop_output.txt 2>&1") }
+    }
+
+    results = gates.transform_values { |gate| gate.call }
+
+    puts "\n  Quality Gate Summary"
+    puts "  #{'─' * 32}"
+    results.each do |gate, ok|
+      badge = ok ? "\e[32mPASS\e[0m" : "\e[31mFAIL\e[0m"
+      file  = gate == :test ? "test_output.txt" : "#{gate}_output.txt"
+      puts "  #{badge}  #{gate.to_s.ljust(10)}  see #{file}"
+    end
+    puts "  #{'─' * 32}"
+
+    if results.values.all?
+      puts "\n  \e[32mAll quality gates passed.\e[0m\n\n"
+    else
+      failed = results.reject { |_, v| v }.keys.join(', ')
+      abort "\n  \e[31mFailed: #{failed}\e[0m\n\n"
+    end
+  end
+
+  # ── Documentation ─────────────────────────────────────────────────────────
+
+  desc "Update README table of contents"
+  def update_toc_in_readmen = sh "rake toc"
+
+  depends_on :update_toc_in_readmen
+  desc "Generate documentation (depends on: update_toc_in_readmen)"
+  def gen_doc = puts "Documentation generated."
+
+  # ── Build & Install ────────────────────────────────────────────────────────
+
+  depends_on :update_toc_in_readmen
+  desc "Install gem locally (depends on: update_toc_in_readmen)"
+  def install = sh "rake install"
+
+  # ── Backup ────────────────────────────────────────────────────────────────
+
+  desc "Backup .envrc and *.loki support files"
+  def backup_support_files
+    backup_loki_files
+    backup_envrc_files
+  end
+
+  # ── Version management ────────────────────────────────────────────────────
+
+  desc "Create a git tag for the current version"
+  def tag = sh "git tag v#{current_version}"
+
+  desc "Push commits and all tags to origin"
+  def push
+    sh "git push"
+    sh "git push origin --tags"
+  end
+
+  desc "bump [LEVEL]", "Increment version level: major, minor, or patch (default: patch)"
+  def bump(level = "patch")
+    require "versionaire"
+    path    = version_filepath
+    old_ver = Versionaire::Version(File.read(path).strip)
+    new_ver = old_ver.bump(level.to_sym)
+    puts "Bumping #{level}:  #{old_ver} to #{new_ver}"
+    File.write(path, "#{new_ver}\n")
+    sh "git add #{path}", silent: true
+  end
+
+  depends_on :tag, :push, :bump
+  desc "Tag the current commit, push it, then bump the version"
+  def tag_push_and_bump = puts "Tagged, pushed, and bumped."
+
+  # ── List ──────────────────────────────────────────────────────────────────
+
+  desc "List available tasks (default)"
+  def list = sh "asgard help"
+
+  # ── Private helpers ───────────────────────────────────────────────────────
+
+  private
+
+  def version_filepath = File.join(@@rr, ".version")
+  def current_version  = File.read(version_filepath).strip
+
+  def backup_loki_files  = sh "backup_just.rb",  silent: true
+  def backup_envrc_files = sh "backup_envrc.rb", silent: true
+
+  def reek_scan
+    require 'reek'
+    require 'reek/configuration/app_configuration'
+    config_path = Pathname.new('.reek.yml')
+    config = config_path.exist? ? Reek::Configuration::AppConfiguration.from_path(config_path) : nil
+    sources = Dir.glob('lib/**/*.rb') + Dir.glob('plugins/**/*.rb')
+    sources.each_with_object({}) do |f, acc|
+      examiner = Reek::Examiner.new(File.read(f), configuration: config)
+      count = examiner.smells.size
+      acc[f] = count if count > 0
+    end
+  end
+
+  def load_reek_baseline
+    path = File.join(@@rr, '.quality', 'reek_baseline.txt')
+    return {} unless File.exist?(path)
+
+    File.readlines(path).each_with_object({}) do |line, acc|
+      count, file = line.strip.split("\t", 2)
+      acc[file] = count.to_i if file && !file.empty?
+    end
+  end
+
+  def reek_gate
+    current  = reek_scan
+    baseline = load_reek_baseline
+    new_files = current.reject { |f, _| baseline.key?(f) }
+    worsened  = current.select { |f, c| baseline.key?(f) && c > baseline[f] }
+    (new_files.empty? && worsened.empty?).tap do |ok|
+      File.write('reek_output.txt', ok ? "Reek quality gate passed.\n" : reek_failure_report(new_files, worsened, current, baseline))
+    end
+  end
+
+  def reek_failure_report(new_files, worsened, current, baseline)
+    lines  = ["Reek quality gate FAILED:\n"]
+    lines += new_files.map { |f, c| format("  NEW      %3d warning(s): %s\n", c, f) }
+    lines += worsened.map  { |f, c| format("  WORSENED %3d -> %3d: %s\n", baseline[f], c, f) }
+    lines.join
+  end
+end

data/.quality/flay_baseline.txt

@@ -0,0 +1 @@
+1866838872

data/.quality/flog_baseline.txt

@@ -0,0 +1,29 @@
+141.7	AIA::ToolFilterStrategy#display_timing_table
+137.5	AIA::ConfigurationDirectives#model
+122.8	AIA::SpecialModeHandler#handle_decomposition
+108.0	AIA::ConfigValidator::load_mcp_tools_grouped
+96.2	AIA::CLIParser::list_available_models
+94.0	AIA::UIPresenter#display_multi_model_metrics
+89.1	AIA::UtilityDirectives#tools
+79.0	AIA::ModelDirectives#show_rubyllm_models
+74.3	AIA::DebateHandler#handle
+71.0	AIA::ConfigurationDirectives#cost
+69.3	AIA::LayeredOrchestrator#handle
+67.1	AIA::UtilityDirectives#mcp
+64.8	AIA::PromptHandler#apply_root_shorthands
+63.2	AIA::ConfigValidator::handle_mcp_list
+62.9	AIA::ModelDirectives#show_ollama_models
+61.9	AIA::ConfigValidator::process_role_configuration
+61.3	AIA::ToolLoader#filtered_tools
+60.7	AIA::SessionTracker#record_network_turn
+60.2	AIA::MCPConnectionManager#connect_one
+58.4	AIA::ChatLoop#speak
+58.4	AIA::WebAndFileDirectives#skills
+57.7	AIA::LayeredOrchestrator#run_specialists_wave
+56.2	AIA::McpParser::convert_mcp_servers_format
+54.8	AIA::MentionRouter#speak
+54.6	AIA::ContextDirectives#review
+54.3	AIA::CLIParser::validate_role_exists
+52.6	AIA::ModelDirectives#show_lms_models
+50.9	AIA::ConfigValidator::load_local_tools
+50.2	AIA::Directive::help

data/.quality/reek_baseline.txt

@@ -0,0 +1,80 @@
+1	lib/aia.rb
+22	lib/aia/chat_loop.rb
+11	lib/aia/config.rb
+23	lib/aia/config/cli_parser.rb
+4	lib/aia/config/mcp_parser.rb
+1	lib/aia/config/model_spec.rb
+23	lib/aia/config/validator.rb
+7	lib/aia/content_extractor.rb
+1	lib/aia/cost_calculator.rb
+1	lib/aia/crew.rb
+8	lib/aia/debate_handler.rb
+6	lib/aia/delegate_handler.rb
+4	lib/aia/directive.rb
+2	lib/aia/directive_processor.rb
+15	lib/aia/directives/configuration_directives.rb
+12	lib/aia/directives/context_directives.rb
+10	lib/aia/directives/execution_directives.rb
+12	lib/aia/directives/model_directives.rb
+1	lib/aia/directives/trakflow_directives.rb
+11	lib/aia/directives/utility_directives.rb
+11	lib/aia/directives/web_and_file_directives.rb
+2	lib/aia/fact_asserter.rb
+1	lib/aia/fzf.rb
+1	lib/aia/history_transfer.rb
+19	lib/aia/layered_orchestrator.rb
+10	lib/aia/logger.rb
+1	lib/aia/mcp_config_normalizer.rb
+17	lib/aia/mcp_connection_manager.rb
+2	lib/aia/mcp_discovery.rb
+1	lib/aia/mcp_grouper.rb
+2	lib/aia/mcp_utility.rb
+17	lib/aia/mention_router.rb
+2	lib/aia/model_switch_handler.rb
+7	lib/aia/network_builder.rb
+2	lib/aia/network_memory_manager.rb
+1	lib/aia/patches/ruby_llm_streaming_error.rb
+2	lib/aia/patches/ruby_llm_tool_error.rb
+15	lib/aia/pipeline_orchestrator.rb
+2	lib/aia/plugin_loader.rb
+6	lib/aia/plugin_monitor.rb
+2	lib/aia/prompt_decomposer.rb
+19	lib/aia/prompt_handler.rb
+1	lib/aia/robot_builder.rb
+7	lib/aia/robot_factory.rb
+1	lib/aia/robot_namer.rb
+12	lib/aia/session.rb
+5	lib/aia/session_tracker.rb
+2	lib/aia/similarity_scorer.rb
+3	lib/aia/skill_utils.rb
+1	lib/aia/spawn_handler.rb
+14	lib/aia/special_mode_handler.rb
+2	lib/aia/startup_coordinator.rb
+8	lib/aia/streaming_runner.rb
+5	lib/aia/system_prompt_assembler.rb
+10	lib/aia/task_coordinator.rb
+2	lib/aia/tfidf_math.rb
+2	lib/aia/tool_filter.rb
+2	lib/aia/tool_filter/tfidf.rb
+1	lib/aia/tool_filter/wordnet_expander.rb
+12	lib/aia/tool_filter_strategy.rb
+13	lib/aia/tool_loader.rb
+1	lib/aia/tools/delegate_to_foreman_tool.rb
+1	lib/aia/tools/recruit_robot_tool.rb
+1	lib/aia/tools/reskill_robot_tool.rb
+4	lib/aia/tools/task_board_tool.rb
+10	lib/aia/trakflow_bridge.rb
+11	lib/aia/turn_state.rb
+7	lib/aia/ui_presenter.rb
+3	lib/aia/utility.rb
+1	lib/aia/variable_input_collector.rb
+1	lib/aia/verification_network.rb
+26	plugins/cli_help_analyzer_tool.rb
+4	plugins/git_context.rb
+1	plugins/joke.rb
+16	plugins/jq_tool.rb
+2	plugins/list_ruby_methods_tool.rb
+7	plugins/memory_tool.rb
+1	plugins/quick_file_tool.rb
+2	plugins/search_files_tool.rb
+10	plugins/search_replace_tool.rb

data/.rubocop.yml

@@ -0,0 +1,116 @@
+inherit_from:
+  - .rubocop_todo.yml
+  - ../.rubocop-base.yml
+  - .rubocop_strict.yml
+
+inherit_mode:
+  merge:
+    - Exclude
+
+AllCops:
+  Exclude:
+    - 'examples/**/*'
+    - 'site/**/*'
+    - 'notes/**/*'
+    - 'docs/**/*'
+    - 'coverage/**/*'
+    - 'pkg/**/*'
+    - 'orchestrated_build_*/**/*'
+    - 'rubyllm_with_schema_test.rb'
+    - 'with_schema_test.rb'
+
+# ── Gemspec: dev deps in gemspec for publisher convenience ───────────────────
+Gemspec/DevelopmentDependencies:
+  EnforcedStyle: gemspec
+  Exclude:
+    - 'Gemfile'
+    - 'Gemfile.local'
+
+# ── Style: intentional lib patterns ─────────────────────────────────────────
+# extend self used in skill_utils.rb so methods are public when included
+Style/ModuleFunction:
+  Exclude:
+    - 'lib/aia/skill_utils.rb'
+
+# $DEBUG_ME is an intentional global for CLI debug toggle
+Style/GlobalVars:
+  Exclude:
+    - 'lib/aia.rb'
+    - 'lib/aia/config/cli_parser.rb'
+
+# %{key} Ruby format tokens are intentional for LLM prompt template interpolation
+Style/FormatStringToken:
+  Enabled: false
+
+# Safe navigation chains > 2 are intentional in this codebase
+Style/SafeNavigationChainLength:
+  Enabled: false
+
+# Duplicate branch bodies are intentional in several dispatch patterns
+Lint/DuplicateBranch:
+  Enabled: false
+
+# ── Test files: relax cops that fire on intentional test patterns ─────────────
+Style/OpenStructUse:
+  Exclude:
+    - 'test/**/*'
+
+Lint/MissingSuper:
+  Exclude:
+    - 'test/**/*'
+
+Lint/FloatComparison:
+  Exclude:
+    - 'test/**/*'
+
+Style/MixinUsage:
+  Exclude:
+    - 'test/test_helper.rb'
+
+Style/OptionalBooleanParameter:
+  Exclude:
+    - 'test/test_helper.rb'
+
+Naming/VariableNumber:
+  Exclude:
+    - 'test/**/*'
+
+Lint/ConstantDefinitionInBlock:
+  Exclude:
+    - 'Rakefile'
+    - 'test/**/*'
+
+Metrics/AbcSize:
+  Max: 40
+  Exclude:
+    - 'test/**/*'
+
+Metrics/MethodLength:
+  Max: 35
+  CountAsOne:
+    - heredoc
+    - array
+    - hash
+  Exclude:
+    - 'test/**/*'
+
+Metrics/BlockLength:
+  Exclude:
+    - 'Rakefile'
+    - '*.gemspec'
+    - 'test/**/*'
+
+Metrics/CyclomaticComplexity:
+  Max: 20
+  Exclude:
+    - 'test/**/*'
+
+Metrics/PerceivedComplexity:
+  Max: 20
+  Exclude:
+    - 'test/**/*'
+
+Metrics/ModuleLength:
+  Max: 200
+  Exclude:
+    - 'test/**/*'

data/.version

@@ -1 +1 @@
-1.1.1
+2.0.0.0-alpha