aircana 3.2.1 → 4.0.0.rc2

data/lib/aircana/generators/skills_generator.rb

@@ -0,0 +1,194 @@
+# frozen_string_literal: true
+
+require_relative "../generators"
+require_relative "../contexts/manifest"
+
+module Aircana
+  module Generators
+    # rubocop:disable Metrics/ClassLength
+    class SkillsGenerator < BaseGenerator
+      attr_reader :kb_name, :short_description, :skill_description, :knowledge_files
+
+      # rubocop:disable Metrics/ParameterLists
+      def initialize(kb_name:, short_description: nil, skill_description: nil, knowledge_files: [], file_in: nil,
+                     file_out: nil)
+        @kb_name = kb_name
+        @short_description = short_description
+        @skill_description = skill_description || generate_skill_description
+        @knowledge_files = knowledge_files
+
+        super(
+          file_in: file_in || default_template_path,
+          file_out: file_out || default_output_path
+        )
+      end
+      # rubocop:enable Metrics/ParameterLists
+
+      # Generate SKILL.md based on manifest data
+      # rubocop:disable Metrics/MethodLength
+      def self.from_manifest(kb_name)
+        manifest = Contexts::Manifest.read_manifest(kb_name)
+        raise Error, "No manifest found for knowledge base '#{kb_name}'" unless manifest
+
+        knowledge_files = extract_knowledge_files_from_manifest(manifest)
+
+        # Warn if no knowledge files were found
+        if knowledge_files.empty?
+          Aircana.human_logger.warn "No knowledge files found for KB '#{kb_name}'. " \
+                                    "SKILL.md will be generated but will be empty. " \
+                                    "Run 'aircana kb refresh #{kb_name}' to fetch knowledge."
+        end
+
+        skill_description = generate_skill_description_from_manifest(manifest, kb_name)
+
+        new(
+          kb_name: kb_name,
+          skill_description: skill_description,
+          knowledge_files: knowledge_files
+        )
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      # Class methods for manifest processing
+      def self.extract_knowledge_files_from_manifest(manifest)
+        kb_name = manifest["name"]
+
+        # If kb_dir exists, scan actual files on disk (preferred method)
+        if kb_name && Aircana.configuration.kb_knowledge_dir
+          kb_dir = Aircana.configuration.kb_path(kb_name)
+
+          return extract_files_from_disk(manifest, kb_dir) if Dir.exist?(kb_dir)
+        end
+
+        # Fallback: extract from manifest metadata (for tests or before files are created)
+        extract_files_from_manifest_metadata(manifest)
+      end
+
+      # rubocop:disable Metrics/MethodLength
+      def self.extract_files_from_disk(manifest, kb_dir)
+        actual_files = Dir.glob(File.join(kb_dir, "*.md"))
+                          .reject { |f| File.basename(f) == "SKILL.md" }
+                          .sort
+
+        # Build file list with summaries from manifest
+        actual_files.map do |filepath|
+          filename = File.basename(filepath)
+          summary = find_summary_for_file(manifest, filename)
+
+          {
+            summary: summary || File.basename(filename, ".md").tr("-", " ").capitalize,
+            filename: filename
+          }
+        end
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
+      # rubocop:disable Metrics/PerceivedComplexity
+      def self.extract_files_from_manifest_metadata(manifest)
+        files = []
+
+        manifest["sources"]&.each do |source|
+          case source["type"]
+          when "confluence"
+            source["pages"]&.each do |page|
+              files << {
+                summary: page["summary"] || "Documentation",
+                filename: "#{sanitize_filename_from_id(page["id"])}.md"
+              }
+            end
+          when "web"
+            source["urls"]&.each do |url_entry|
+              files << {
+                summary: url_entry["summary"] || "Web resource",
+                filename: "#{sanitize_filename_from_url(url_entry["url"])}.md"
+              }
+            end
+          end
+        end
+
+        files
+      end
+      # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
+      # rubocop:enable Metrics/PerceivedComplexity
+
+      # Find the summary for a given filename from the manifest
+      # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
+      # rubocop:disable Metrics/PerceivedComplexity
+      def self.find_summary_for_file(manifest, filename)
+        manifest["sources"]&.each do |source|
+          case source["type"]
+          when "confluence"
+            source["pages"]&.each do |page|
+              return page["summary"] if filename.include?(page["id"])
+            end
+          when "web"
+            source["urls"]&.each do |url_entry|
+              sanitized_url_part = sanitize_filename_from_url(url_entry["url"])
+              return url_entry["summary"] if filename.include?(sanitized_url_part)
+            end
+          end
+        end
+
+        nil
+      end
+      # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
+      # rubocop:enable Metrics/PerceivedComplexity
+
+      def self.generate_skill_description_from_manifest(manifest, kb_name)
+        # Generate a description optimized for Claude's skill discovery
+        source_count = manifest["sources"]&.size || 0
+        "Discover critical context for #{kb_name.split("-").join(" ")} from #{source_count} knowledge sources"
+      end
+
+      def self.sanitize_filename_from_id(page_id)
+        "page_#{page_id}"
+      end
+
+      def self.sanitize_filename_from_url(url)
+        # Extract meaningful name from URL
+        uri = URI.parse(url)
+        path_segments = uri.path.split("/").reject(&:empty?)
+
+        if path_segments.any?
+          path_segments.last.gsub(/[^a-z0-9\-_]/i, "-").gsub(/-+/, "-").downcase
+        else
+          uri.host.gsub(/[^a-z0-9\-_]/i, "-").gsub(/-+/, "-").downcase
+        end
+      rescue URI::InvalidURIError
+        "web_resource"
+      end
+      # rubocop:enable Metrics/ClassLength
+
+      protected
+
+      def locals
+        super.merge({
+                      kb_name:,
+                      skill_description:,
+                      knowledge_files:
+                    })
+      end
+
+      private
+
+      def default_template_path
+        File.join(File.dirname(__FILE__), "..", "templates", "skills", "base_skill.erb")
+      end
+
+      def default_output_path
+        File.join(Aircana.configuration.skills_dir, kb_name, "SKILL.md")
+      end
+
+      def generate_skill_description
+        return @skill_description if @skill_description
+
+        if @short_description
+          "Discover critical context for #{short_description}"
+        else
+          "Discover critical context for #{kb_name.split("-").join(" ")}"
+        end
+      end
+    end
+  end
+end

data/lib/aircana/templates/skills/base_skill.erb

@@ -0,0 +1,12 @@
+---
+name: Learn <%= kb_name.split("-").map(&:capitalize).join(" ") %>
+description: <%= skill_description %>
+---
+
+# Learn <%= kb_name.split("-").map(&:capitalize).join(" ") %>
+
+## Instructions
+Choose a sub-topic most relevant to your current task:
+<% knowledge_files.each do |file| %>
+* <%= file[:summary] %>: [<%= file[:filename] %>](<%= file[:filename] %>)
+<% end %>

data/lib/aircana/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Aircana
-  VERSION = "3.2.1"
+  VERSION = "4.0.0.rc2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aircana
 version: !ruby/object:Gem::Version
-  version: 3.2.1
+  version: 4.0.0.rc2
 platform: ruby
 authors:
 - Weston Dransfield
@@ -127,7 +127,6 @@ files:
 - lib/aircana.rb
 - lib/aircana/cli.rb
 - lib/aircana/cli/app.rb
-- lib/aircana/cli/commands/agents.rb
 - lib/aircana/cli/commands/doctor.rb
 - lib/aircana/cli/commands/doctor_checks.rb
 - lib/aircana/cli/commands/doctor_helpers.rb
@@ -135,6 +134,7 @@ files:
 - lib/aircana/cli/commands/generate.rb
 - lib/aircana/cli/commands/hooks.rb
 - lib/aircana/cli/commands/init.rb
+- lib/aircana/cli/commands/kb.rb
 - lib/aircana/cli/commands/plugin.rb
 - lib/aircana/cli/help_formatter.rb
 - lib/aircana/cli/shell_command.rb
@@ -150,7 +150,6 @@ files:
 - lib/aircana/contexts/web.rb
 - lib/aircana/fzf_helper.rb
 - lib/aircana/generators.rb
-- lib/aircana/generators/agents_generator.rb
 - lib/aircana/generators/apply_feedback_command_generator.rb
 - lib/aircana/generators/ask_expert_command_generator.rb
 - lib/aircana/generators/base_generator.rb
@@ -160,6 +159,7 @@ files:
 - lib/aircana/generators/plan_command_generator.rb
 - lib/aircana/generators/record_command_generator.rb
 - lib/aircana/generators/review_command_generator.rb
+- lib/aircana/generators/skills_generator.rb
 - lib/aircana/hooks_manifest.rb
 - lib/aircana/human_logger.rb
 - lib/aircana/initializers.rb
@@ -167,13 +167,6 @@ files:
 - lib/aircana/plugin_manifest.rb
 - lib/aircana/progress_tracker.rb
 - lib/aircana/system_checker.rb
-- lib/aircana/templates/agents/base_agent.erb
-- lib/aircana/templates/agents/defaults/apply_feedback.erb
-- lib/aircana/templates/agents/defaults/executor.erb
-- lib/aircana/templates/agents/defaults/jira.erb
-- lib/aircana/templates/agents/defaults/planner.erb
-- lib/aircana/templates/agents/defaults/reviewer.erb
-- lib/aircana/templates/agents/defaults/sub-agent-coordinator.erb
 - lib/aircana/templates/commands/apply_feedback.erb
 - lib/aircana/templates/commands/ask_expert.erb
 - lib/aircana/templates/commands/execute.erb
@@ -184,20 +177,13 @@ files:
 - lib/aircana/templates/hooks/notification_sqs.erb
 - lib/aircana/templates/hooks/post_tool_use.erb
 - lib/aircana/templates/hooks/pre_tool_use.erb
-- lib/aircana/templates/hooks/refresh_agents.erb
 - lib/aircana/templates/hooks/rspec_test.erb
 - lib/aircana/templates/hooks/rubocop_pre_commit.erb
 - lib/aircana/templates/hooks/session_start.erb
-- lib/aircana/templates/hooks/sync_local_knowledge.erb
 - lib/aircana/templates/hooks/user_prompt_submit.erb
+- lib/aircana/templates/skills/base_skill.erb
 - lib/aircana/version.rb
 - sig/aircana.rbs
-- spec_target_1760656566_428/agents/test-agent/manifest.json
-- spec_target_1760656588_38/agents/test-agent/manifest.json
-- spec_target_1760656647_612/agents/test-agent/manifest.json
-- spec_target_1760656660_113/agents/test-agent/manifest.json
-- spec_target_1760656689_268/agents/test-agent/manifest.json
-- spec_target_1760656710_387/agents/test-agent/manifest.json
 homepage: https://github.com/westonkd/aircana
 licenses:
 - MIT