jackdaw 1.0.0

data/lib/jackdaw/commands/build.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Jackdaw
+  module Commands
+    # Build command implementation
+    class Build
+      include CLIHelpers
+
+      def initialize(project, options)
+        @project = project
+        @options = options
+      end
+
+      def execute
+        return handle_missing_project unless @project.exists?
+
+        header('🚀 Building your site...')
+        info('Cleaning output directory...') if @options[:clean]
+
+        # Build
+        builder = Builder.new(@project, @options)
+        stats = builder.build
+
+        # Show results
+        puts ''
+        display_results(stats)
+      end
+
+      private
+
+      def handle_missing_project
+        puts colorize('✗ No site directory found. Run this command from a .site directory.', :yellow)
+        exit 1
+      end
+
+      def display_results(stats)
+        if stats.success?
+          show_success(stats)
+        else
+          show_errors(stats)
+          exit 1
+        end
+      end
+
+      def show_success(stats)
+        success("Built #{colorize(stats.files_built.to_s,
+                                  :cyan)} pages in #{colorize(format('%.2fs', stats.total_time), :cyan)}")
+
+        info("Skipped #{stats.files_skipped} unchanged files") if stats.files_skipped.positive?
+        info("Copied #{stats.assets_copied} assets") if stats.assets_copied.positive?
+
+        return unless stats.assets_skipped.positive? && @options[:verbose]
+
+        info("Skipped #{stats.assets_skipped} unchanged assets")
+      end
+
+      def show_errors(stats)
+        puts colorize("✗ Build failed with #{stats.errors.length} errors:", :yellow)
+        stats.errors.each do |error|
+          puts "  #{colorize('→', :yellow)} #{error.message}"
+          puts "    #{error.backtrace.first}" if @options[:verbose] && error.backtrace
+        end
+      end
+    end
+  end
+end

data/lib/jackdaw/commands/create.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+module Jackdaw
+  module Commands
+    # Create command implementation
+    class Create
+      include CLIHelpers
+
+      DATED_TYPES = %w[blog post article news].freeze
+
+      def initialize(project, template, name, options)
+        @project = project
+        @template = template
+        @name = name
+        @options = options
+      end
+
+      def execute
+        unless @project.exists?
+          puts colorize('✗ No site directory found. Run this command from a .site directory.', :yellow)
+          exit 1
+        end
+
+        validate_template!
+        create_content_file
+      end
+
+      private
+
+      def validate_template!
+        template_file = File.join(@project.templates_dir, "#{@template}.html.erb")
+        return if File.exist?(template_file)
+
+        puts colorize("✗ Template '#{@template}' not found", :yellow)
+        puts "  Run #{colorize('jackdaw template list', :cyan)} to see available templates"
+        exit 1
+      end
+
+      def create_content_file
+        filename = build_filename
+        output_path = build_output_path(filename)
+
+        check_file_exists!(output_path)
+        ensure_directory_exists!(output_path)
+        write_content_file!(output_path)
+        show_success_message(output_path)
+      end
+
+      def build_filename
+        slug = generate_slug
+        add_date_prefix? ? "#{date_prefix}-#{slug}.#{@template}.md" : "#{slug}.#{@template}.md"
+      end
+
+      def generate_slug
+        path_parts = @name.split('/')
+        @filename_part = path_parts.pop
+        @subdir = path_parts.join('/')
+
+        @filename_part.downcase.gsub(/[^a-z0-9]+/, '-').gsub(/^-|-$/, '')
+      end
+
+      def add_date_prefix?
+        if @options[:no_date]
+          false
+        elsif @options[:dated]
+          true
+        else
+          DATED_TYPES.include?(@template)
+        end
+      end
+
+      def date_prefix
+        Time.now.strftime('%Y-%m-%d')
+      end
+
+      def build_output_path(filename)
+        output_dir = @subdir.empty? ? @project.src_dir : File.join(@project.src_dir, @subdir)
+        File.join(output_dir, filename)
+      end
+
+      def check_file_exists!(output_path)
+        return unless File.exist?(output_path)
+
+        puts colorize("✗ File already exists: #{output_path}", :yellow)
+        exit 1
+      end
+
+      def ensure_directory_exists!(output_path)
+        FileUtils.mkdir_p(File.dirname(output_path))
+      end
+
+      def write_content_file!(output_path)
+        title = @name.split('/').last
+        content = <<~MARKDOWN
+          # #{title}
+
+          Your content goes here. Edit this file to create your #{@template}.
+        MARKDOWN
+
+        File.write(output_path, content)
+      end
+
+      def show_success_message(output_path)
+        relative_path = output_path.sub("#{Dir.pwd}/", '')
+        puts ''
+        success("Created #{colorize(@template, :cyan)}: #{colorize(relative_path, :green)}")
+        info("Edit: #{colorize(relative_path, :cyan)}")
+      end
+    end
+  end
+end

data/lib/jackdaw/commands/new.rb

@@ -0,0 +1,162 @@
+# frozen_string_literal: true
+
+module Jackdaw
+  module Commands
+    # New command implementation for creating new site projects
+    class New
+      include CLIHelpers
+
+      def initialize(name)
+        @name = name
+        @site_dir = "#{name}.site"
+      end
+
+      def execute
+        check_directory_exists!
+
+        header("✨ Creating new site: #{@name}")
+        create_project_structure
+        show_next_steps
+      end
+
+      private
+
+      def check_directory_exists!
+        return unless Dir.exist?(@site_dir)
+
+        puts colorize("✗ Directory #{@site_dir} already exists", :yellow)
+        exit 1
+      end
+
+      def create_project_structure
+        info('Creating directory structure...')
+        project = Project.new(@site_dir)
+        project.create!
+
+        create_starter_templates(project)
+        create_example_content(project)
+        create_gitignore(project)
+
+        success("Site created at #{colorize(@site_dir, :cyan)}")
+      end
+
+      def create_starter_templates(project)
+        create_layout_template(project)
+        create_nav_partial(project)
+        create_page_template(project)
+        create_blog_template(project)
+
+        success('Created starter templates')
+      end
+
+      def create_layout_template(project)
+        layout_template = File.join(project.templates_dir, 'layout.html.erb')
+        File.write(layout_template, <<~ERB)
+          <!DOCTYPE html>
+          <html lang="en">
+          <head>
+            <meta charset="UTF-8">
+            <meta name="viewport" content="width=device-width, initial-scale=1.0">
+            <title><%= title %> - <%= site_name %></title>
+            <style>
+              body { max-width: 800px; margin: 0 auto; padding: 2rem; font-family: system-ui; line-height: 1.6; }
+              nav { margin-bottom: 2rem; padding-bottom: 1rem; border-bottom: 1px solid #ddd; }
+              nav a { margin-right: 1rem; text-decoration: none; }
+            </style>
+          </head>
+          <body>
+            <%= render 'nav' %>
+            <%= content %>
+          </body>
+          </html>
+        ERB
+      end
+
+      def create_nav_partial(project)
+        nav_partial = File.join(project.templates_dir, '_nav.html.erb')
+        File.write(nav_partial, <<~ERB)
+          <nav>
+            <a href="/">Home</a>
+            <a href="/blog">Blog</a>
+          </nav>
+        ERB
+      end
+
+      def create_page_template(project)
+        page_template = File.join(project.templates_dir, 'page.html.erb')
+        File.write(page_template, <<~ERB)
+          <main>
+            <%= content %>
+          </main>
+        ERB
+      end
+
+      def create_blog_template(project)
+        blog_template = File.join(project.templates_dir, 'blog.html.erb')
+        File.write(blog_template, <<~ERB)
+          <article>
+            <header>
+              <h1><%= title %></h1>
+              <time datetime="<%= date %>"><%= date.strftime('%B %d, %Y') %></time>
+            </header>
+            <%= content %>
+          </article>
+        ERB
+      end
+
+      def create_example_content(project)
+        create_index_page(project)
+        create_first_blog_post(project)
+
+        success('Created example content')
+      end
+
+      def create_index_page(project)
+        index_page = File.join(project.src_dir, 'index.page.md')
+        File.write(index_page, <<~MD)
+          # Welcome to Jackdaw
+
+          This is your new static site, built with lightning-fast Jackdaw.
+
+          ## Getting Started
+
+          Edit this file at `site/src/index.page.md` and run `jackdaw build` to see your changes.
+        MD
+      end
+
+      def create_first_blog_post(project)
+        blog_dir = File.join(project.src_dir, 'blog')
+        FileUtils.mkdir_p(blog_dir)
+
+        first_post = File.join(blog_dir, '2026-01-06-hello-world.blog.md')
+        File.write(first_post, <<~MD)
+          # Hello World
+
+          Welcome to your first blog post! This post demonstrates:
+
+          - Automatic date extraction from filename
+          - Title extraction from the first H1
+          - Folder structure preservation
+
+          Edit this file at `site/src/blog/2026-01-06-hello-world.blog.md`
+        MD
+      end
+
+      def create_gitignore(project)
+        gitignore = File.join(project.root, '.gitignore')
+        File.write(gitignore, <<~IGNORE)
+          public/
+          .DS_Store
+        IGNORE
+        success('Created .gitignore')
+      end
+
+      def show_next_steps
+        puts "\n#{colorize('Next steps:', :bold)}"
+        info("cd #{@site_dir}")
+        info('jackdaw build')
+        info('jackdaw serve')
+      end
+    end
+  end
+end

data/lib/jackdaw/commands/serve.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Jackdaw
+  module Commands
+    # Serve command implementation
+    class Serve
+      include CLIHelpers
+
+      def initialize(project, options)
+        @project = project
+        @options = options
+      end
+
+      def execute
+        unless @project.exists?
+          puts colorize('✗ No site directory found. Run this command from a .site directory.', :yellow)
+          exit 1
+        end
+
+        server = Server.new(@project, @options)
+        server.start
+      rescue Interrupt
+        puts "\n\n#{colorize('👋 Server stopped', :magenta)}"
+        exit 0
+      end
+    end
+  end
+end

data/lib/jackdaw/commands/template.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Jackdaw
+  module Commands
+    # Template subcommands
+    class Template < Thor
+      include CLIHelpers
+
+      def self.exit_on_failure?
+        true
+      end
+
+      desc 'list', 'List available templates'
+      def list
+        project = Project.new
+
+        unless project.exists?
+          puts colorize('✗ No site directory found. Run this command from a .site directory.', :yellow)
+          exit 1
+        end
+
+        template_files = find_template_files(project)
+
+        if template_files.empty?
+          puts colorize('No templates found in site/templates/', :yellow)
+          exit 0
+        end
+
+        display_templates(template_files)
+        show_usage_examples
+      end
+
+      private
+
+      def find_template_files(project)
+        Dir.glob(File.join(project.templates_dir, '*.html.erb'))
+           .map { |f| File.basename(f, '.html.erb') }
+           .reject { |name| name == 'layout' || name.start_with?('_') }
+           .sort
+      end
+
+      def display_templates(template_files)
+        puts "\n#{colorize('Available templates:', :bold)}"
+        template_files.each do |template|
+          dated_types = %w[blog post article news]
+          dated_indicator = dated_types.include?(template) ? colorize(' (dated)', :cyan) : ''
+          puts "  #{colorize('→', :green)} #{colorize(template, :cyan)}#{dated_indicator}"
+        end
+      end
+
+      def show_usage_examples
+        puts "\n#{colorize('Usage:', :bold)}"
+        puts '  jackdaw create <template> <name>'
+        puts "\n#{colorize('Examples:', :bold)}"
+        puts '  jackdaw create page "About Us"'
+        puts '  jackdaw create blog "My First Post"'
+      end
+    end
+  end
+end

data/lib/jackdaw/feed_generator.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+module Jackdaw
+  # Generates RSS and Atom feeds for blog posts
+  class FeedGenerator
+    attr_reader :project, :scanner
+
+    def initialize(project)
+      @project = project
+      @scanner = Scanner.new(project)
+    end
+
+    # Generate RSS feed for blog posts
+    def generate_rss
+      posts = blog_posts.take(20) # Most recent 20 posts
+      
+      rss = <<~RSS
+        <?xml version="1.0" encoding="UTF-8"?>
+        <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+          <channel>
+            <title>#{site_name}</title>
+            <link>#{site_url}</link>
+            <description>#{site_description}</description>
+            <language>en</language>
+            <atom:link href="#{site_url}/feed.xml" rel="self" type="application/rss+xml" />
+            #{posts.map { |post| rss_item(post) }.join("\n")}
+          </channel>
+        </rss>
+      RSS
+
+      File.write(File.join(project.output_dir, 'feed.xml'), rss)
+    end
+
+    # Generate Atom feed for blog posts
+    def generate_atom
+      posts = blog_posts.take(20)
+      updated = posts.first&.date&.to_time&.utc&.iso8601 || Time.now.utc.iso8601
+
+      atom = <<~ATOM
+        <?xml version="1.0" encoding="UTF-8"?>
+        <feed xmlns="http://www.w3.org/2005/Atom">
+          <title>#{site_name}</title>
+          <link href="#{site_url}" />
+          <link href="#{site_url}/atom.xml" rel="self" />
+          <updated>#{updated}</updated>
+          <id>#{site_url}/</id>
+          <author>
+            <name>#{site_name}</name>
+          </author>
+          #{posts.map { |post| atom_entry(post) }.join("\n")}
+        </feed>
+      ATOM
+
+      File.write(File.join(project.output_dir, 'atom.xml'), atom)
+    end
+
+    private
+
+    def blog_posts
+      @blog_posts ||= scanner.content_files
+                             .select { |f| %w[blog post article news].include?(f.type) }
+                             .sort_by(&:date)
+                             .reverse
+    end
+
+    def rss_item(post)
+      <<~ITEM.strip
+            <item>
+              <title>#{escape_xml(post.title)}</title>
+              <link>#{site_url}/#{post.output_path}</link>
+              <guid>#{site_url}/#{post.output_path}</guid>
+              <pubDate>#{post.date.to_time.utc.rfc822}</pubDate>
+              <description>#{escape_xml(post.excerpt)}</description>
+            </item>
+      ITEM
+    end
+
+    def atom_entry(post)
+      <<~ENTRY.strip
+          <entry>
+            <title>#{escape_xml(post.title)}</title>
+            <link href="#{site_url}/#{post.output_path}" />
+            <id>#{site_url}/#{post.output_path}</id>
+            <updated>#{post.date.to_time.utc.iso8601}</updated>
+            <summary>#{escape_xml(post.excerpt)}</summary>
+          </entry>
+      ENTRY
+    end
+
+    def site_name
+      project_name = File.basename(project.root)
+      project_name.sub(/\.site$/, '').tr('-', ' ').split.map(&:capitalize).join(' ')
+    end
+
+    def site_url
+      # Default to localhost for development, can be overridden
+      ENV.fetch('SITE_URL', 'http://localhost:4000')
+    end
+
+    def site_description
+      "Latest posts from #{site_name}"
+    end
+
+    def escape_xml(text)
+      text.to_s
+          .gsub('&', '&amp;')
+          .gsub('<', '&lt;')
+          .gsub('>', '&gt;')
+          .gsub('"', '&quot;')
+          .gsub("'", '&apos;')
+    end
+  end
+end

data/lib/jackdaw/file_types.rb

@@ -0,0 +1,171 @@
+# frozen_string_literal: true
+
+module Jackdaw
+  # Base class for all file types
+  class BaseFile
+    attr_reader :path, :project
+
+    def initialize(path, project)
+      @path = File.expand_path(path)
+      @project = project
+    end
+
+    def basename
+      File.basename(path)
+    end
+
+    def mtime
+      File.mtime(path)
+    end
+
+    def relative_path
+      path.sub("#{base_dir}/", '')
+    end
+
+    def base_dir
+      raise NotImplementedError
+    end
+  end
+
+  # Represents a content file (*.*.md)
+  class ContentFile < BaseFile
+    def base_dir
+      project.src_dir
+    end
+
+    # Extract type from filename (e.g., "hello.blog.md" -> "blog")
+    def type
+      @type ||= begin
+        parts = basename.split('.')
+        parts[-2] if parts.length >= 3
+      end
+    end
+
+    # Extract name from filename (e.g., "2026-01-06-hello.blog.md" -> "hello")
+    def name
+      @name ||= begin
+        base = basename.sub(/\.#{type}\.md$/, '')
+        # Remove date prefix if present
+        base.sub(/^\d{4}-\d{2}-\d{2}-/, '')
+      end
+    end
+
+    # Extract date from filename or fall back to mtime
+    def date
+      @date ||= if basename =~ /^(\d{4}-\d{2}-\d{2})-/
+                  Date.parse(::Regexp.last_match(1))
+                else
+                  Date.parse(mtime.strftime('%Y-%m-%d'))
+                end
+    end
+
+    # Slug for URL (e.g., "hello_world" or "2026-01-06-hello_world")
+    def slug
+      @slug ||= name.gsub('_', '-')
+    end
+
+    # Output path relative to public/
+    def output_path
+      dir = File.dirname(relative_path)
+      filename = "#{name}.html"
+      dir == '.' ? filename : File.join(dir, filename)
+    end
+
+    # Full output path
+    def output_file
+      File.join(project.output_dir, output_path)
+    end
+
+    # Read raw content
+    def content
+      @content ||= File.read(path)
+    end
+
+    # Extract title from first H1
+    def title
+      @title ||= begin
+        match = content.match(/^#\s+(.+)$/)
+        match ? match[1].strip : name.gsub(/[-_]/, ' ').capitalize
+      end
+    end
+
+    # Extract excerpt (first paragraph or 150 words)
+    def excerpt
+      @excerpt ||= begin
+        # Remove title (first H1)
+        text = content.sub(/^#\s+.+$/, '').strip
+
+        # Get first paragraph or first 150 words
+        first_para = text.split("\n\n").first
+        words = first_para.to_s.split[0...150]
+        excerpt_text = words.join(' ')
+
+        # Add ellipsis if truncated
+        excerpt_text += '...' if words.length == 150
+        excerpt_text
+      end
+    end
+
+    # Calculate reading time (words per minute = 200)
+    def reading_time
+      @reading_time ||= begin
+        word_count = content.split.length
+        minutes = (word_count / 200.0).ceil
+        [minutes, 1].max
+      end
+    end
+
+    # Metadata hash
+    def metadata
+      {
+        title: title,
+        date: date,
+        slug: slug,
+        type: type,
+        path: output_path,
+        excerpt: excerpt,
+        reading_time: reading_time
+      }
+    end
+  end
+
+  # Represents a template file (*.html.erb)
+  class TemplateFile < BaseFile
+    def base_dir
+      project.templates_dir
+    end
+
+    # Extract template type (e.g., "blog.html.erb" -> "blog")
+    def type
+      @type ||= basename.sub(/\.html\.erb$/, '')
+    end
+
+    # Read template content
+    def content
+      @content ||= File.read(path)
+    end
+  end
+
+  # Represents an asset file
+  class AssetFile < BaseFile
+    def base_dir
+      project.assets_dir
+    end
+
+    # Output path relative to public/
+    def output_path
+      relative_path
+    end
+
+    # Full output path
+    def output_file
+      File.join(project.output_dir, output_path)
+    end
+
+    # Copy asset to output
+    def copy!
+      FileUtils.mkdir_p(File.dirname(output_file))
+      FileUtils.cp(path, output_file)
+    end
+  end
+end