fresco 0.0.1

data/lib/fresco/cli/new.rb

@@ -0,0 +1,120 @@
+require "erb"
+require "fileutils"
+
+require "fresco/paths"
+
+module Fresco
+  class CLI
+    class New
+      USAGE = <<~USAGE
+        Usage: fresco new <app_name> [--fresco-path <dir>]
+
+          --fresco-path <dir>   Generate a Gemfile pinned to a path-installed
+                                fresco (instead of the rubygems version). Useful
+                                during co-development of fresco itself.
+
+        Example:
+          fresco new bookshelf
+          fresco new bookshelf --fresco-path ../fresco
+      USAGE
+
+      def run(argv)
+        app_name = nil
+        fresco_path = nil
+        i = 0
+        while i < argv.length
+          a = argv[i]
+          if a == "--fresco-path"
+            fresco_path = argv[i + 1]
+            unless fresco_path
+              warn "fresco: --fresco-path requires a directory argument"
+              return 1
+            end
+            i += 2
+          elsif a.start_with?("-")
+            warn "fresco: unknown flag #{a.inspect}"
+            warn USAGE
+            return 1
+          else
+            if app_name
+              warn "fresco: positional <app_name> already set to #{app_name.inspect}"
+              return 1
+            end
+            app_name = a
+            i += 1
+          end
+        end
+
+        if app_name.nil? || app_name.empty?
+          warn USAGE
+          return 1
+        end
+
+        unless app_name.match?(/\A[a-z][a-z0-9_]*\z/)
+          warn "fresco: app name #{app_name.inspect} must be lowercase letters/digits/underscores starting with a letter"
+          return 1
+        end
+
+        target = File.expand_path(app_name)
+        if File.exist?(target)
+          warn "fresco: #{target} already exists"
+          return 1
+        end
+
+        locals = {
+          app_name:      app_name,
+          module_name:   camelize(app_name),
+          fresco_source: fresco_path ? ", path: #{File.expand_path(fresco_path).inspect}" : "",
+        }
+
+        FileUtils.mkdir_p(target)
+        scaffold_root = Fresco::Paths.generator_root
+
+        copied = 0
+        Dir.glob("#{scaffold_root}/**/*", File::FNM_DOTMATCH).sort.each do |src|
+          next if src.end_with?("/.", "/..")
+          rel = src.sub(/\A#{Regexp.escape(scaffold_root)}\/?/, "")
+          next if rel.empty?
+          dst = File.join(target, strip_template_suffix(rel))
+
+          if File.directory?(src)
+            FileUtils.mkdir_p(dst)
+            next
+          end
+
+          FileUtils.mkdir_p(File.dirname(dst))
+          if src.end_with?(".tt")
+            File.write(dst, ERB.new(File.read(src), trim_mode: "-").result_with_hash(locals))
+          else
+            FileUtils.cp(src, dst)
+          end
+
+          # Preserve executable bit for bin/* scripts (cp doesn't strip it,
+          # but ERB-rendered .tt files re-create with default 0644). The
+          # generator tree doesn't currently put .tt files under bin/, but
+          # chmod here makes the rule uniform.
+          File.chmod(0o755, dst) if rel.start_with?("bin/")
+          copied += 1
+        end
+
+        puts "Created #{app_name}/ (#{copied} files)"
+        puts ""
+        puts "    cd #{app_name}"
+        puts "    bundle install"
+        puts "    bin/dev"
+        puts ""
+        0
+      end
+
+      private
+
+      def camelize(name)
+        name.split("_").map(&:capitalize).join
+      end
+
+      def strip_template_suffix(rel)
+        rel.end_with?(".tt") ? rel[0...-3] : rel
+      end
+    end
+  end
+end

data/lib/fresco/cli/release.rb

@@ -0,0 +1,76 @@
+require "fileutils"
+
+module Fresco
+  class CLI
+    class Release
+      # On macOS, libpq's headers ship in Homebrew's keg-only `libpq`
+      # formula (or Postgres.app), so they're not in cc's default
+      # include path. Auto-detect a few known locations and prepend
+      # them to CPATH / LIBRARY_PATH so Spinel's compile of the
+      # postgres.c shim finds libpq-fe.h / -lpq without the user
+      # having to remember the export dance. SQLite builds are
+      # unaffected — cc ignores include/lib paths that nothing
+      # references.
+      LIBPQ_ROOTS = [
+        "/opt/homebrew/opt/libpq",
+        "/usr/local/opt/libpq",
+        "/Applications/Postgres.app/Contents/Versions/latest",
+      ].freeze
+
+      def run(argv = [])
+        # Regenerate generated/* first so the binary picks up any
+        # routes/views/actions that changed since the last dev cycle.
+        require "fresco/cli/build"
+        Fresco::CLI::Build.new.run
+
+        export_libpq_env!
+
+        spinel = find_spinel_binary
+        unless spinel
+          abort <<~MSG
+            [release] no spinel binary found. Tried: ./spinel, vendor/spinel/bin/spinel, $PATH.
+            Build Spinel from https://github.com/.../spinel and place the binary at
+            ./spinel, vendor/spinel/bin/spinel, or on your PATH.
+          MSG
+        end
+
+        FileUtils.mkdir_p("build")
+        unless system(spinel, "app.rb", "-o", "build/app")
+          abort "[release] spinel failed; see output above"
+        end
+
+        size = File.size("build/app")
+        puts "built build/app (#{size} bytes)"
+        0
+      end
+
+      private
+
+      def export_libpq_env!
+        LIBPQ_ROOTS.each do |root|
+          header = File.join(root, "include/libpq-fe.h")
+          next unless File.exist?(header)
+          prepend_env("CPATH",        File.join(root, "include"))
+          prepend_env("LIBRARY_PATH", File.join(root, "lib"))
+          puts "[release] using libpq at #{root}"
+          break
+        end
+      end
+
+      def prepend_env(var, dir)
+        existing = ENV[var]
+        ENV[var] = existing && !existing.empty? ? "#{dir}:#{existing}" : dir
+      end
+
+      # Spinel binary lookup ladder. Order matches the messages the
+      # release script prints on miss; keep them in sync if you change
+      # one.
+      def find_spinel_binary
+        return File.expand_path("./spinel")              if File.executable?("./spinel")
+        return File.expand_path("vendor/spinel/bin/spinel") if File.executable?("vendor/spinel/bin/spinel")
+        path = `command -v spinel 2>/dev/null`.strip
+        path.empty? ? nil : path
+      end
+    end
+  end
+end

data/lib/fresco/cli.rb

@@ -0,0 +1,56 @@
+require "fresco/version"
+
+# Subcommand dispatcher. Each command lives in lib/fresco/cli/<name>.rb
+# as a class with a #run(argv) method; we load lazily so `fresco --help`
+# doesn't pay for parsing herb / loading the dev loop.
+module Fresco
+  class CLI
+    COMMANDS = {
+      "new"     => "Fresco::CLI::New",
+      "build"   => "Fresco::CLI::Build",
+      "dev"     => "Fresco::CLI::Dev",
+      "release" => "Fresco::CLI::Release",
+    }.freeze
+
+    def self.start(argv)
+      cmd = argv.first
+
+      if cmd.nil? || cmd == "--help" || cmd == "-h"
+        print_usage
+        return 0
+      end
+
+      if cmd == "--version" || cmd == "-v"
+        puts "fresco #{Fresco::VERSION}"
+        return 0
+      end
+
+      const_name = COMMANDS[cmd]
+      unless const_name
+        warn "fresco: unknown command #{cmd.inspect}"
+        print_usage
+        return 1
+      end
+
+      require "fresco/cli/#{cmd}"
+      klass = const_name.split("::").inject(Object) { |m, n| m.const_get(n) }
+      klass.new.run(argv[1..])
+    end
+
+    def self.print_usage
+      puts <<~USAGE
+        Usage: fresco <command> [args]
+
+        Commands:
+          new <name>    Scaffold a new Fresco app in ./<name>/
+          build         Regenerate generated/* from config + app/
+          dev           Run the CRuby dev loop (build + watch + serve)
+          release       Build a Spinel-compiled binary at ./build/app
+
+        Flags:
+          -h, --help     Show this message
+          -v, --version  Show fresco version
+      USAGE
+    end
+  end
+end

data/lib/fresco/database_config.rb

@@ -0,0 +1,34 @@
+# Build-time + runtime-safe database config slots. Populated by
+# config/database.rb's `Fresco.database :sqlite, ...` (or :postgres)
+# call. `fresco build` reads `database_adapter` to decide which adapter
+# template to copy into `generated/db_adapter.rb`; at runtime the
+# same file is re-loaded as part of the boot chain so ENV.fetch'd
+# values (paths, URLs) resolve in the running binary's environment
+# rather than at build time.
+#
+# Three typed scalars instead of one hash — see the note in
+# lib/fresco/runtime/runtime.rb for the Spinel poly-hash + nil-init traps.
+# Mirrored verbatim there so build-time and runtime stay in sync.
+module Fresco
+  @database_adapter = :none
+  @database_path    = ""
+  @database_url     = ""
+
+  def self.database_adapter
+    @database_adapter
+  end
+
+  def self.database_path
+    @database_path
+  end
+
+  def self.database_url
+    @database_url
+  end
+
+  def self.database(adapter, path: "", url: "")
+    @database_adapter = adapter
+    @database_path    = path
+    @database_url     = url
+  end
+end

data/lib/fresco/generators/app/Gemfile.tt

@@ -0,0 +1,18 @@
+source "https://gem.coop"
+
+gem "fresco"<%= fresco_source %>
+
+group :development do
+  # Lints user code against the Spinel-acceptable Ruby subset.
+  # `fresco build` runs this and fails the build on violations.
+  gem "rubocop_spinel"
+
+  # Powers `fresco dev`'s CRuby stand-in for the SQLite FFI shim.
+  # Production binaries link libsqlite3 directly via the gem-shipped
+  # sqlite.c — this is a dev-only convenience so actions that hit
+  # Fresco::Db::Active work under CRuby without a Spinel recompile.
+  gem "sqlite3"
+
+  # Uncomment if you switch the adapter in config/database.rb.
+  # gem "pg"
+end

data/lib/fresco/generators/app/README.md.tt

@@ -0,0 +1,32 @@
+# <%= app_name %>
+
+A Fresco app — Ruby that compiles to a static binary via Spinel.
+
+## Getting started
+
+```
+bundle install
+bin/dev
+```
+
+Then open <http://localhost:3030/>.
+
+## Layout
+
+- `app/actions/` — request handlers. Add a file, point a route at it.
+- `app/views/` — ERB templates compiled at build time.
+- `app/models/` — model declarations (drive generated DB helpers).
+- `config/routes.rb` — route table.
+- `config/database.rb` — adapter + DSN.
+- `db/schema.rb` — table definitions.
+- `db/migrations/` — versioned SQL migrations.
+
+## Commands
+
+- `bin/dev` — CRuby dev loop with auto-reload. Edit + refresh.
+- `bin/build` — regenerate `generated/` without booting the server.
+- `bin/release` — compile a production binary to `build/app`.
+
+You'll need the `spinel` binary on PATH (or symlinked into this
+directory) for `bin/release`. See the Fresco docs for how to obtain
+it.

data/lib/fresco/generators/app/app/action.rb.tt

@@ -0,0 +1,20 @@
+# Shared base for all actions in this application. Concrete actions
+# under app/actions/ inherit from this rather than Fresco::Action
+# directly, so cross-cutting changes (layouts, filters, helper
+# methods) stay in one place.
+#
+# Filters available from the framework base:
+#   - #before_action(req)      — override to run pre-call code; call
+#                                halt!(resp) to short-circuit #call.
+#   - #after_action(req, res)  — override to run post-call code; call
+#                                halt!(resp) to replace the response.
+#   - #handle(req) + super     — wrap the whole pipeline ("around").
+module <%= module_name %>
+  class Action < Fresco::Action
+    # Default layout for every action. Override `#layout` on a
+    # specific action class (or return :none) to opt out per-action.
+    def layout
+      :application
+    end
+  end
+end

data/lib/fresco/generators/app/app/actions/root_path.rb.tt

@@ -0,0 +1,5 @@
+class RootPath < <%= module_name %>::Action
+  def call(req = Request.new("", "", ""))
+    render(render_root_path)
+  end
+end

data/lib/fresco/generators/app/app/views/layouts/application.html.erb

@@ -0,0 +1,29 @@
+<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8">
+    <title>Fresco App</title>
+    <style>
+      body {
+        font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+        max-width: 40rem;
+        margin: 2rem auto;
+        padding: 0 1.5rem;
+        color: #222;
+      }
+      header nav a { color: #0066cc; text-decoration: none; margin-right: 1rem; }
+      header nav a:hover { text-decoration: underline; }
+      code { background: #f3f3f3; padding: 0.1rem 0.3rem; border-radius: 3px; }
+      footer { color: #888; font-size: 0.85rem; border-top: 1px solid #eee; margin-top: 2rem; padding-top: 1rem; }
+    </style>
+  </head>
+  <body>
+    <header>
+      <nav><a href="/">home</a></nav>
+    </header>
+    <main>
+      <%= yield %>
+    </main>
+    <footer><small>Powered by Spinel + Fresco.</small></footer>
+  </body>
+</html>

data/lib/fresco/generators/app/app/views/root_path.html.erb

@@ -0,0 +1,8 @@
+<h1>Welcome to Fresco</h1>
+<p>You're up and running. Edit <code>app/views/root_path.html.erb</code> to change this page, or add new actions under <code>app/actions/</code>.</p>
+<p>Next steps:</p>
+<ul>
+  <li>Define routes in <code>config/routes.rb</code>.</li>
+  <li>Add a database in <code>config/database.rb</code>, then declare your schema in <code>db/schema.rb</code>.</li>
+  <li>Run <code>bin/release</code> to produce a Spinel-compiled binary at <code>build/app</code>.</li>
+</ul>

data/lib/fresco/generators/app/app.rb.tt

@@ -0,0 +1,15 @@
+# Fresco: entry point. Spinel reads this file; everything reachable
+# via require_relative gets AOT-compiled into the binary.
+#
+# The boot file (auto-generated by `fresco build`) wires the load
+# order: runtime → views → config/app → action manifest → dispatcher.
+# Everything that changes per-app lives in config/, app/, or
+# app/views/ — this file stays a one-liner plus the boot call.
+#
+# Spinel quirk: ARGV is read directly inside Fresco::App rather
+# than passed in — the sp_Argv type doesn't survive being routed
+# through a Ruby parameter.
+
+require_relative "generated/boot"
+
+<%= module_name %>::Base.run

data/lib/fresco/generators/app/bin/build

@@ -0,0 +1,2 @@
+#!/usr/bin/env bash
+exec bundle exec fresco build "$@"

data/lib/fresco/generators/app/bin/dev

@@ -0,0 +1,2 @@
+#!/usr/bin/env bash
+exec bundle exec fresco dev "$@"

data/lib/fresco/generators/app/bin/release

@@ -0,0 +1,2 @@
+#!/usr/bin/env bash
+exec bundle exec fresco release "$@"

data/lib/fresco/generators/app/config/app.rb.tt

@@ -0,0 +1,26 @@
+# Boot-time customization point. `<%= module_name %>::Base.new` is
+# instantiated from app.rb at startup, so anything set in #initialize
+# takes effect before the listener spawns.
+
+# Sign signed-session cookies (and anything else that uses HMAC) with
+# the value of $SESSION_SECRET. Falls back to a placeholder for the
+# dev loop so /session works out of the box; production deployments
+# MUST set the env var to a long random string (e.g. 64 hex bytes
+# from `openssl rand -hex 32`). Empty value silently disables
+# sessions entirely.
+#
+# Split the ENV read from the assignment instead of `ENV.fetch(key,
+# default)`: Spinel's two-arg `ENV.fetch` codegen emits a `const
+# char *` ternary but the surrounding context wraps the result in
+# `sp_box_str`, producing an "assigning to 'const char *' from
+# incompatible type 'sp_RbVal'" compile error at the setter site.
+session_secret = ENV["SESSION_SECRET"]
+if session_secret.nil? || session_secret.empty?
+  session_secret = "dev-only-INSECURE-session-secret-change-me-for-prod"
+end
+Fresco.set_session_secret(session_secret)
+
+module <%= module_name %>
+  class Base < Fresco::App
+  end
+end

data/lib/fresco/generators/app/config/database.rb

@@ -0,0 +1,17 @@
+# Fresco: database configuration. Loaded twice — once by `fresco
+# build` to capture the adapter symbol (drives the codegen template
+# selection in generated/db_adapter.rb), and once at runtime as part
+# of boot.rb so ENV.fetch'd values resolve in the running binary's
+# environment rather than at build time.
+#
+# Switching adapters requires re-running `fresco build` (the linker
+# picks one C shim or the other; we don't link both). For SQLite, the
+# path can be `:memory:` for an ephemeral in-process DB, or any
+# filesystem path. For Postgres, pass any libpq conninfo string —
+# `postgres://user@host/db` or `host=... user=... dbname=...`.
+
+Fresco.database :sqlite,
+  path: ENV.fetch("DATABASE_PATH", "db/app.sqlite3")
+
+# Fresco.database :postgres,
+#   url: ENV.fetch("DATABASE_URL", "postgres://localhost/app_dev")

data/lib/fresco/generators/app/config/routes.rb

@@ -0,0 +1,11 @@
+# Fresco: route definitions.
+#
+# Evaluated by `fresco build` under CRuby. The block captures (verb,
+# pattern, action_class) triples on Fresco.app.routes; build emits
+# generated/dispatch.rb from them. Not loaded at runtime —
+# production reads the generated dispatcher.
+
+Fresco.app.routes do
+  # Uncomment and edit the line below to define your app's root route. Example:
+  # root to: RootPath
+end

data/lib/fresco/generators/app/db/schema.rb

@@ -0,0 +1,14 @@
+# Fresco: schema declaration. Loaded by `fresco build` to drive model
+# codegen. Add tables with:
+#
+#   Fresco.schema do
+#     table :users do
+#       column :id, :int, primary_key: true
+#       column :email, :str, null: false, index: :unique
+#     end
+#   end
+#
+# Runtime never loads this file — generated/models/*.rb are
+# self-contained.
+Fresco.schema do
+end

data/lib/fresco/generators/app/public/404.html

@@ -0,0 +1,87 @@
+<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8">
+    <title>404 — Not Found</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;700&display=swap" rel="stylesheet">
+    <script>
+      // Pre-paint so the page doesn't flash light before JS runs. If
+      // the user has no stored preference we seed from the OS, then
+      // persist so subsequent visits skip the matchMedia probe.
+      (function () {
+        var t = localStorage.getItem("theme");
+        if (!t) {
+          t = (window.matchMedia && window.matchMedia("(prefers-color-scheme: dark)").matches) ? "dark" : "light";
+          localStorage.setItem("theme", t);
+        }
+        document.documentElement.setAttribute("data-theme", t);
+      })();
+    </script>
+    <style>
+      :root {
+        --bg: #fff; --fg: #222; --muted: #888;
+        --border: #eee; --code-bg: #f7f7f7;
+        --accent: #0066cc; --status: #888;
+      }
+      :root[data-theme="dark"] {
+        --bg: #141414; --fg: #e8e8e8; --muted: #9a9a9a;
+        --border: #2a2a2a; --code-bg: #1f1f1f;
+        --accent: #6ab0ff; --status: #b8b8b8;
+      }
+      body {
+        font-family: 'IBM Plex Mono', ui-monospace, SFMono-Regular, Menlo, monospace;
+        max-width: 40rem;
+        margin: 4rem auto;
+        padding: 0 1.5rem;
+        background: var(--bg);
+        color: var(--fg);
+        transition: background 0.15s, color 0.15s;
+      }
+      h1 { font-weight: 700; font-size: 1.5rem; margin-bottom: 0.25rem; }
+      .status { color: var(--status); font-size: 0.9rem; letter-spacing: 0.05em; text-transform: uppercase; }
+      p { line-height: 1.5; }
+      code { background: var(--code-bg); padding: 0.1rem 0.3rem; border-radius: 3px; }
+      a { color: var(--accent); }
+      a:hover { text-decoration: underline; }
+      hr { border: none; border-top: 1px solid var(--border); margin: 2rem 0; }
+      footer { color: var(--muted); font-size: 0.85rem; }
+      #theme-toggle {
+        position: fixed; top: 1rem; right: 1rem;
+        background: transparent; border: 1px solid var(--border);
+        color: var(--fg); border-radius: 6px;
+        padding: 0.4rem; cursor: pointer;
+        display: inline-flex; align-items: center; justify-content: center;
+      }
+      #theme-toggle:hover { background: var(--code-bg); }
+      #theme-toggle svg { width: 18px; height: 18px; display: none; }
+      :root[data-theme="light"] #theme-toggle .icon-moon { display: inline-block; }
+      :root[data-theme="dark"]  #theme-toggle .icon-sun  { display: inline-block; }
+    </style>
+  </head>
+  <body>
+    <button id="theme-toggle" aria-label="Toggle color theme" title="Toggle color theme">
+      <svg class="icon-sun" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="4"/><path d="M12 2v2"/><path d="M12 20v2"/><path d="m4.93 4.93 1.41 1.41"/><path d="m17.66 17.66 1.41 1.41"/><path d="M2 12h2"/><path d="M20 12h2"/><path d="m6.34 17.66-1.41 1.41"/><path d="m19.07 4.93-1.41 1.41"/></svg>
+      <svg class="icon-moon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/></svg>
+    </button>
+
+    <div class="status">404 &middot; Not Found</div>
+    <h1>That page isn't here.</h1>
+    <p>The URL you requested didn't match any route, or the file you asked for doesn't exist under <code>public/</code>.</p>
+    <p><a href="/">Back to home</a></p>
+    <hr>
+    <footer>Powered by Spinel + Fresco.</footer>
+
+    <script>
+      (function () {
+        document.getElementById("theme-toggle").addEventListener("click", function () {
+          var cur = document.documentElement.getAttribute("data-theme");
+          var nxt = cur === "dark" ? "light" : "dark";
+          document.documentElement.setAttribute("data-theme", nxt);
+          localStorage.setItem("theme", nxt);
+        });
+      })();
+    </script>
+  </body>
+</html>