monkeyspaw 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ce5d0090a65680d9d35a3db4165f9b1ecaa9a07da2077e109c69d00b0696773
-  data.tar.gz: 95657a5e46c0070e16ee55adb4ecbbffb0252f297760b695b83c7dc930001063
+  metadata.gz: a1db0335d3959caf2685ba8091103b01117690dc6ef220d3e97179978e9e4378
+  data.tar.gz: 9cea5693ddfbce5a195b7eb40f870533850226e44b75132b190640ca0cc54506
 SHA512:
-  metadata.gz: 18e5f453eb95c34cc32873bba6a4cfc1ca4572bf47a1315fabe71badf5dd0b830a8d2e857118ca14892617b7388d1ab84113066a69bd8161d1dd1e4e91147079
-  data.tar.gz: 7bad4ea29d4dc33d18cbf15e723b3c87e07f9680f961865fd8325b0dfdaa625b6c0b9f9c7dbde9351e050d29d77f386b23d9f36182b0324f0ab5c77eeff71eb6
+  metadata.gz: f5b484f83ac1a0582ff8eef6039246c6135476236e09fc4a34d3bb089f6487a414a7a7cd8fd74cbfe5c79c9ef02c111e2ddf567755c5ee0f1fb873b4b5725321
+  data.tar.gz: 11e986e1d6b3c9f48310a8dab9f8c36b8fef051fb8b51c640bcff0b0d29f72b7bc677adbb5eab07073da04e25b878cfb84a635c609317386215ee22a6e126d6f

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sublayer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,143 @@
+# MonkeysPaw 🐒✋
+
+> *Be careful what you wish for...*
+
+A prompt-driven web framework for Ruby that grants your web development wishes through the power of AI. Like the legendary monkey's paw, it will fulfill your requests exactly as stated—for better or worse.
+
+## The Curse and the Gift
+
+MonkeysPaw removes traditional web development constraints by allowing you to express your intentions through prompts rather than code. But remember, with great power comes the responsibility to be precise. Your words shape reality here.
+
+The quality of what you receive depends entirely on how carefully you phrase your wishes.
+
+## Installation
+
+Summon the paw into your application:
+
+```ruby
+gem 'monkeyspaw'
+```
+
+Then invoke the ritual:
+
+```bash
+$ bundle install
+```
+
+Or bind it directly:
+
+```bash
+$ gem install monkeyspaw
+```
+
+## Making Your First Wish
+
+Create a simple manifestation with just a few incantations:
+
+```ruby
+require 'monkeyspaw'
+
+# Make your wish come true
+MonkeysPaw.pick_up!
+```
+
+That's it! MonkeysPaw will interpret your desires by:
+
+1. Reading prompt files from the `wishes/` directory
+2. Channeling the AI entity to manifest your content
+3. Summoning a web server (default: http://localhost:1337)
+
+## Structuring Your Desires
+
+MonkeysPaw follows arcane file-based conventions:
+
+```
+your-project/
+├── wishes/                  # Your primary desires
+│   ├── index.md            # Home page (/)
+│   ├── about.md            # About page (/about)
+│   └── curses/
+│       ├── 01-wish.md      # First curse (/curses/01-wish)
+│       └── 02-consequence.md  # Second curse (/curses/02-consequence)
+├── components/             # Recurring incantations
+│   ├── layout.md           # The container of all things
+│   └── navigation.md       # Pathways between realms
+├── assets/                 # Physical manifestations
+│   └── images/
+│       └── paw-mark.png
+└── app.rb                  # Where the magic begins
+```
+
+## Crafting Effective Wishes (Prompts)
+
+The art of prompt crafting is delicate. Be specific, or face the consequences of ambiguity:
+
+```markdown
+# Page: Introduction to MonkeysPaw
+
+## Content Instructions:
+Create an engaging introduction to a framework that grants web development wishes 
+through AI prompts. Emphasize the need for precise language.
+
+## Key Points:
+- The dual nature of wish fulfillment: power and peril
+- How imprecise wishes lead to unexpected outcomes
+- Examples of well-crafted vs. poorly-crafted prompts
+
+## Style:
+- Mysterious yet professional tone
+- Include a cautionary opening statement
+- End with advice for the wish-maker
+
+## Visual Elements:
+- A clear warning header
+- Short, foreboding paragraphs
+- A callout box with "Do's and Don'ts" for prompt crafting
+```
+
+## Controlling Your Fate
+
+Configure the terms of your pact:
+
+```ruby
+MonkeysPaw.configure do |config|
+  config.port = 4567
+  config.host = 'localhost'
+end
+```
+
+## Mystical Entities Available for Summoning (TODO)
+
+MonkeysPaw can channel various AI entities:
+
+```ruby
+# The Gemini Spirit
+MonkeysPaw.use :gemini, model: :gemini_2_0_flash
+
+# The OpenAI Oracle
+MonkeysPaw.use :openai, model: :gpt_4
+
+# The Anthropic Sage
+MonkeysPaw.use :anthropic, model: :claude_3_opus
+
+# The Mistral Wind
+MonkeysPaw.use :mistral, model: :mistral_large
+```
+
+## Words of Caution
+
+1. **Be Precise**: Ambiguity is your enemy. The more specific your wishes, the fewer surprises you'll face.
+   
+2. **Test Your Wishes**: Always preview the manifestation of your wishes before sharing them with others.
+
+3. **Expect Variations**: Even with careful crafting, each wish may manifest slightly differently on each request.
+
+4. **Mind Your Resources**: Frequent wishes may deplete your API quota. Use caching wisely.
+
+## The Binding Contract (License)
+
+MonkeysPaw is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+---
+
+*"The paw grants exactly what you request, not what you intend."*

data/lib/monkeyspaw/application.rb

@@ -11,6 +11,15 @@ module MonkeysPaw
       @server = nil
       @router = nil
       @prompt_manager = nil
+      @cache_manager = nil
+    end
+    
+    def prompt_manager
+      @prompt_manager ||= PromptManager.new(self)
+    end
+    
+    def cache_manager
+      @cache_manager ||= CacheManager.new(self)
     end
 
     def configure
@@ -26,15 +35,16 @@ module MonkeysPaw
       setup_directories
 
       @router ||= Router.new(self)
-
-      @prompt_manager ||= PromptManager.new(self)
+      
+      # Initialize prompt manager
+      prompt_manager
 
       @server ||= Server.new(self, **options)
       @server.start
     end
 
     def pages_dir
-      root.join(config.pages_dir || 'pages')
+      root.join(config.pages_dir || 'wishes')
     end
 
     def components_dir

data/lib/monkeyspaw/cache_manager.rb

@@ -0,0 +1,98 @@
+require 'digest'
+require 'fileutils'
+
+module MonkeysPaw
+  class CacheManager
+    attr_reader :app, :cache_dir
+
+    def initialize(app)
+      @app = app
+      @cache_dir = app.root.join('.monkeyspaw_cache')
+      @cache_dir.mkpath unless @cache_dir.exist?
+    end
+
+    def get_cached_page(path, prompt_file)
+      cache_key = generate_cache_key(path, prompt_file)
+      cache_file = cache_dir.join("#{cache_key}.html")
+
+      return nil unless cache_file.exist?
+
+      # If the cache exists, check if any dependencies have changed
+      if dependencies_changed?(path, prompt_file)
+        puts "Dependencies changed for #{path}, regenerating..."
+        return nil
+      end
+
+      puts "Using cached version of #{path}"
+      File.read(cache_file)
+    end
+
+    def cache_page(path, prompt_file, html_content)
+      cache_key = generate_cache_key(path, prompt_file)
+      cache_file = cache_dir.join("#{cache_key}.html")
+
+      # Save the HTML content
+      File.write(cache_file, html_content)
+
+      # Save dependency information
+      save_dependencies(path, prompt_file)
+
+      puts "Cached page #{path}"
+    end
+
+    def clear_cache
+      FileUtils.rm_rf(cache_dir)
+      cache_dir.mkpath
+      puts "Cache cleared"
+    end
+
+    private
+
+    def generate_cache_key(path, prompt_file)
+      # Create a unique but readable key based on the path
+      safe_path = path.gsub(/[^a-zA-Z0-9_-]/, '_')
+      safe_path = 'index' if safe_path == '_'
+      safe_path
+    end
+
+    def dependencies_changed?(path, prompt_file)
+      deps_file = cache_dir.join("#{generate_cache_key(path, prompt_file)}.deps")
+      return true unless deps_file.exist?
+
+      current_deps = get_current_dependencies(path, prompt_file)
+      stored_deps = JSON.parse(File.read(deps_file))
+
+      # Compare the stored and current dependencies
+      current_deps != stored_deps
+    end
+
+    def get_current_dependencies(path, prompt_file)
+      deps = {}
+
+      # Page content dependency
+      deps["page"] = file_signature(prompt_file)
+
+      # Layout component dependency
+      layout_file = app.prompt_manager.get_component_prompt('layout')
+      deps["layout"] = layout_file ? file_signature(layout_file) : app.prompt_manager.default_layout_prompt
+
+      # Style component dependency
+      style_file = app.prompt_manager.get_component_prompt('style')
+      deps["style"] = style_file ? file_signature(style_file) : app.prompt_manager.default_style_prompt
+
+      deps
+    end
+
+    def save_dependencies(path, prompt_file)
+      deps_file = cache_dir.join("#{generate_cache_key(path, prompt_file)}.deps")
+      deps = get_current_dependencies(path, prompt_file)
+
+      File.write(deps_file, JSON.generate(deps))
+    end
+
+    def file_signature(file_path)
+      content = File.read(file_path)
+      Digest::MD5.hexdigest(content)
+    end
+  end
+end

data/lib/monkeyspaw/config.rb

@@ -6,16 +6,18 @@ module MonkeysPaw
                   :components_dir,
                   :assets_dir,
                   :port,
-                  :host
+                  :host,
+                  :caching_enabled
 
     def initialize
       @provider = nil
       @model = nil
-      @pages_dir = 'pages'
+      @pages_dir = 'wishes'
       @components_dir = 'components'
       @assets_dir = 'assets'
       @port = 1337
       @host = "localhost"
+      @caching_enabled = true
     end
 
     def to_h

data/lib/monkeyspaw/generators/html_from_description_generator.rb

@@ -4,24 +4,68 @@ module MonkeysPaw
       name: "html_code",
       description: "The generated HTML code for the web page"
 
-    def initialize(description:)
+    def initialize(description:, layout_prompt: nil, style_prompt: nil)
       @description = description
+      @layout_prompt = layout_prompt
+      @style_prompt = style_prompt
     end
 
     def generate
-      super
+      max_retries = 3
+      retry_count = 0
+      
+      begin
+        super
+      rescue => e
+        retry_count += 1
+        if retry_count <= max_retries
+          puts "Generator attempt #{retry_count}/#{max_retries} failed: #{e.message}. Retrying..."
+          sleep(1) # Add a small delay between retries
+          retry
+        else
+          puts "Generator failed after #{max_retries} attempts. Last error: #{e.message}"
+          raise
+        end
+      end
     end
 
     def prompt
-      <<-PROMPT
+      layout_section = ""
+      style_section = ""
+
+      if @layout_prompt
+        layout_section = <<~LAYOUT_SECTION
+          ## Layout Requirements:
+          #{@layout_prompt}
+        LAYOUT_SECTION
+      end
+
+      if @style_prompt
+        style_section = <<~STYLE_SECTION
+          ## Style Guidelines:
+          #{@style_prompt}
+        STYLE_SECTION
+      end
+
+      <<~PROMPT
         You are an expert HTML developer.
 
         You are tasked with writing HTML code based on the following description:
 
         #{@description}
 
+        #{layout_section}
+        #{style_section}
+
         Take a deep breath and think step by step before you start coding. Ensure the HTML is well-formed and valid.
+        
+        The three components work together as follows:
+        1. The page description provides the specific content and features this page should have
+        2. The layout requirements define the structural organization and placement of elements
+        3. The style guidelines inform the visual presentation and aesthetic choices
+        
+        Harmonize these elements to create a cohesive and effective web page that fulfills the intended purpose.
       PROMPT
     end
   end
-end
+end

data/lib/monkeyspaw/prompt_manager.rb

@@ -1,15 +1,74 @@
 module MonkeysPaw
   class PromptManager
     attr_reader :app
+    attr_accessor :layout_prompt, :style_prompt
 
     def initialize(app)
       @app = app
+      load_default_components
     end
 
     def get_page_prompt(path)
       path = "/" if path.empty?
-
       app.router.get_file(path)
     end
+
+    def get_component_prompt(component_name)
+      component_file = app.components_dir.join("#{component_name}.md")
+      component_file if component_file.exist?
+    end
+
+    def load_layout_prompt
+      layout_file = get_component_prompt('layout')
+      if layout_file
+        @layout_prompt = File.read(layout_file)
+      else
+        @layout_prompt = default_layout_prompt
+      end
+    end
+
+    def load_style_prompt
+      style_file = get_component_prompt('style')
+      if style_file
+        @style_prompt = File.read(style_file)
+      else
+        @style_prompt = default_style_prompt
+      end
+    end
+
+    def load_default_components
+      load_layout_prompt
+      load_style_prompt
+    end
+
+    private
+
+    def default_layout_prompt
+      <<~LAYOUT
+        # Layout Component
+
+        Create a simple and clean layout with:
+        - A responsive header at the top with the page title
+        - A main content area that contains the primary content
+        - A footer with copyright information
+        - Navigation links if appropriate for the context
+
+        The layout should be responsive and work well on mobile and desktop devices.
+      LAYOUT
+    end
+
+    def default_style_prompt
+      <<~STYLE
+        # Style Component
+
+        Apply these styling guidelines:
+        - Use a clean, minimalist design with ample white space
+        - Color scheme: soft blues (#4A90E2) for primary elements, light gray (#F5F5F5) for backgrounds
+        - Typography: Sans-serif fonts (system-ui) with good readability
+        - Interactive elements should have subtle hover effects
+        - Content should be well-structured with clear hierarchy
+        - Ensure good contrast for accessibility
+      STYLE
+    end
   end
-end
+end

data/lib/monkeyspaw/server.rb

@@ -28,7 +28,30 @@ module MonkeysPaw
     end
 
     def generate_page(path, prompt_file)
-      HtmlFromDescriptionGenerator.new(description: File.read(prompt_file)).generate
+      if app.config.caching_enabled
+        # Try to get from cache first
+        cached_content = app.cache_manager.get_cached_page(path, prompt_file)
+        return cached_content if cached_content
+      end
+      
+      # Cache miss or caching disabled, generate the page
+      # Reload layout and style prompts to pick up changes
+      app.prompt_manager.load_default_components
+      layout_prompt = app.prompt_manager.layout_prompt
+      style_prompt = app.prompt_manager.style_prompt
+
+      html_content = HtmlFromDescriptionGenerator.new(
+        description: File.read(prompt_file),
+        layout_prompt: layout_prompt,
+        style_prompt: style_prompt
+      ).generate
+      
+      # Store in cache if enabled
+      if app.config.caching_enabled
+        app.cache_manager.cache_page(path, prompt_file, html_content)
+      end
+      
+      html_content
     end
 
     private
@@ -79,5 +102,8 @@ module MonkeysPaw
       end
     end
 
+    def generate_error_page(message)
+      "<html><body><h1>Error</h1><p>#{message}</p></body></html>"
+    end
   end
 end

data/lib/monkeyspaw/version.rb

@@ -1,3 +1,3 @@
 module MonkeysPaw
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/lib/monkeyspaw.rb

@@ -6,6 +6,7 @@ require "monkeyspaw/config"
 require "monkeyspaw/server"
 require "monkeyspaw/router"
 require "monkeyspaw/prompt_manager"
+require "monkeyspaw/cache_manager"
 
 Dir[File.expand_path("../monkeyspaw/generators/*.rb", __FILE__)].each { |f| require f }
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: monkeyspaw
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Scott Werner
@@ -117,9 +117,12 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- LICENSE
+- README.md
 - exe/monkeyspaw
 - lib/monkeyspaw.rb
 - lib/monkeyspaw/application.rb
+- lib/monkeyspaw/cache_manager.rb
 - lib/monkeyspaw/config.rb
 - lib/monkeyspaw/generators/html_from_description_generator.rb
 - lib/monkeyspaw/prompt_manager.rb