feat: add download page with platform detection and Homebrew tap automation

- Add /download page with automatic platform detection (macOS/Linux/Windows)
- Integrate GitHub Releases API with localStorage caching
- Add platform override for manual binary selection
- Add Download link to navigation header
- Add Homebrew tap auto-update job to release workflow
- Bump version to 1.3.0

Author: cameronrye

.github/workflows/release.yml

@@ -91,3 +91,16 @@ jobs:
 
       - name: Publish to npm with provenance
         run: npm publish --provenance --access public
+
+  homebrew:
+    needs: release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Update Homebrew formula
+        uses: mislav/bump-homebrew-formula-action@v3
+        with:
+          formula-name: clarissa
+          homebrew-tap: cameronrye/homebrew-tap
+          download-url: https://github.com/cameronrye/clarissa/releases/download/${{ github.ref_name }}/clarissa-macos-arm64
+        env:
+          COMMITTER_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}

docs/.astro/data-store.json

@@ -1 +1 @@
-[["Map",1,2],"meta::meta",["Map",3,4,5,6],"astro-version","5.16.4","astro-config-digest","{\"root\":{},\"srcDir\":{},\"publicDir\":{},\"outDir\":{},\"cacheDir\":{},\"site\":\"https://cameronrye.github.io\",\"compressHTML\":true,\"base\":\"/clarissa/\",\"trailingSlash\":\"always\",\"output\":\"static\",\"scopedStyleStrategy\":\"attribute\",\"build\":{\"format\":\"directory\",\"client\":{},\"server\":{},\"assets\":\"_assets\",\"serverEntry\":\"entry.mjs\",\"redirects\":true,\"inlineStylesheets\":\"auto\",\"concurrency\":1},\"server\":{\"open\":false,\"host\":false,\"port\":4321,\"streaming\":true,\"allowedHosts\":[]},\"redirects\":{},\"image\":{\"endpoint\":{\"route\":\"/_image/\"},\"service\":{\"entrypoint\":\"astro/assets/services/sharp\",\"config\":{}},\"domains\":[],\"remotePatterns\":[],\"responsiveStyles\":false},\"devToolbar\":{\"enabled\":true},\"markdown\":{\"syntaxHighlight\":{\"type\":\"shiki\",\"excludeLangs\":[\"math\"]},\"shikiConfig\":{\"langs\":[],\"langAlias\":{},\"theme\":\"github-dark\",\"themes\":{},\"wrap\":false,\"transformers\":[]},\"remarkPlugins\":[],\"rehypePlugins\":[],\"remarkRehype\":{},\"gfm\":true,\"smartypants\":true},\"security\":{\"checkOrigin\":true,\"allowedDomains\":[]},\"env\":{\"schema\":{},\"validateSecrets\":false},\"experimental\":{\"clientPrerender\":false,\"contentIntellisense\":false,\"headingIdCompat\":false,\"preserveScriptOrder\":false,\"liveContentCollections\":false,\"csp\":false,\"staticImportMetaEnv\":false,\"chromeDevtoolsWorkspace\":false,\"failOnPrerenderConflict\":false,\"svgo\":false},\"legacy\":{\"collections\":false}}"]
+[["Map",1,2],"meta::meta",["Map",3,4,5,6],"astro-version","5.16.4","astro-config-digest","{\"root\":{},\"srcDir\":{},\"publicDir\":{},\"outDir\":{},\"cacheDir\":{},\"site\":\"https://clarissa.run\",\"compressHTML\":true,\"base\":\"/\",\"trailingSlash\":\"always\",\"output\":\"static\",\"scopedStyleStrategy\":\"attribute\",\"build\":{\"format\":\"directory\",\"client\":{},\"server\":{},\"assets\":\"_assets\",\"serverEntry\":\"entry.mjs\",\"redirects\":true,\"inlineStylesheets\":\"auto\",\"concurrency\":1},\"server\":{\"open\":false,\"host\":false,\"port\":4321,\"streaming\":true,\"allowedHosts\":[]},\"redirects\":{},\"image\":{\"endpoint\":{\"route\":\"/_image/\"},\"service\":{\"entrypoint\":\"astro/assets/services/sharp\",\"config\":{}},\"domains\":[],\"remotePatterns\":[],\"responsiveStyles\":false},\"devToolbar\":{\"enabled\":true},\"markdown\":{\"syntaxHighlight\":{\"type\":\"shiki\",\"excludeLangs\":[\"math\"]},\"shikiConfig\":{\"langs\":[],\"langAlias\":{},\"theme\":\"github-dark\",\"themes\":{},\"wrap\":false,\"transformers\":[]},\"remarkPlugins\":[],\"rehypePlugins\":[],\"remarkRehype\":{},\"gfm\":true,\"smartypants\":true},\"security\":{\"checkOrigin\":true,\"allowedDomains\":[]},\"env\":{\"schema\":{},\"validateSecrets\":false},\"experimental\":{\"clientPrerender\":false,\"contentIntellisense\":false,\"headingIdCompat\":false,\"preserveScriptOrder\":false,\"liveContentCollections\":false,\"csp\":false,\"staticImportMetaEnv\":false,\"chromeDevtoolsWorkspace\":false,\"failOnPrerenderConflict\":false,\"svgo\":false},\"legacy\":{\"collections\":false}}"]

docs/.astro/types.d.ts

@@ -1,2 +1 @@
 /// <reference types="astro/client" />
-/// <reference path="content.d.ts" />

docs/src/components/Header.astro

@@ -4,11 +4,11 @@ const currentPath = Astro.url.pathname;
 
 const navItems = [
   { href: `${base}`, label: 'Home' },
+  { href: `${base}download/`, label: 'Download' },
   { href: `${base}docs/installation/`, label: 'Installation' },
   { href: `${base}docs/configuration/`, label: 'Configuration' },
   { href: `${base}docs/tools/`, label: 'Tools' },
   { href: `${base}docs/mcp/`, label: 'MCP' },
-  { href: `${base}docs/usage/`, label: 'Usage' },
 ];
 ---
 

docs/src/pages/download.astro

@@ -0,0 +1,196 @@
+---
+import Base from '../layouts/Base.astro';
+import Header from '../components/Header.astro';
+import Footer from '../components/Footer.astro';
+
+const base = import.meta.env.BASE_URL;
+---
+
+<Base title="Download" description="Download Clarissa for your platform - macOS, Linux, or Windows">
+  <Header />
+  <main class="download-page">
+    <div class="container">
+      <h1 class="gradient-text">Download Clarissa</h1>
+      <p class="subtitle">Get the standalone binary for your platform</p>
+
+      <div id="download-section" class="download-section">
+        <div class="loading">Loading latest release...</div>
+      </div>
+
+      <div class="alternative-install">
+        <h2>Alternative Installation Methods</h2>
+        <div class="install-options">
+          <div class="install-option">
+            <h3>npm / Bun</h3>
+            <p>Install globally with your preferred package manager:</p>
+            <div class="install-command">
+              <code>bun install -g clarissa</code>
+              <button class="copy-btn" data-copy="bun install -g clarissa" aria-label="Copy">
+                <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                  <rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect>
+                  <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path>
+                </svg>
+              </button>
+            </div>
+            <div class="install-command">
+              <code>npm install -g clarissa</code>
+              <button class="copy-btn" data-copy="npm install -g clarissa" aria-label="Copy">
+                <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                  <rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect>
+                  <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path>
+                </svg>
+              </button>
+            </div>
+          </div>
+          <div class="install-option">
+            <h3>Homebrew (macOS)</h3>
+            <p>Install via Homebrew tap:</p>
+            <div class="install-command">
+              <code>brew install cameronrye/tap/clarissa</code>
+              <button class="copy-btn" data-copy="brew install cameronrye/tap/clarissa" aria-label="Copy">
+                <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                  <rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect>
+                  <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path>
+                </svg>
+              </button>
+            </div>
+          </div>
+          <div class="install-option">
+            <h3>From Source</h3>
+            <p>Clone and build from the repository:</p>
+            <div class="install-command">
+              <code>git clone https://github.com/cameronrye/clarissa.git && cd clarissa && bun install && bun link</code>
+              <button class="copy-btn" data-copy="git clone https://github.com/cameronrye/clarissa.git && cd clarissa && bun install && bun link" aria-label="Copy">
+                <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                  <rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect>
+                  <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path>
+                </svg>
+              </button>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </main>
+  <Footer />
+</Base>
+
+<script>
+  import { initDownloadPage } from '../scripts/download.ts';
+  initDownloadPage();
+
+  document.querySelectorAll('.copy-btn').forEach(btn => {
+    btn.addEventListener('click', async () => {
+      const text = btn.getAttribute('data-copy');
+      if (text) {
+        await navigator.clipboard.writeText(text);
+        btn.classList.add('copied');
+        setTimeout(() => btn.classList.remove('copied'), 2000);
+      }
+    });
+  });
+</script>
+
+<style>
+  .download-page {
+    padding: 4rem 0;
+    min-height: 70vh;
+  }
+
+  .download-page h1 {
+    text-align: center;
+    font-size: 2.5rem;
+    margin-bottom: 0.5rem;
+  }
+
+  .subtitle {
+    text-align: center;
+    color: var(--color-text-muted);
+    margin-bottom: 3rem;
+  }
+
+  .download-section {
+    max-width: 800px;
+    margin: 0 auto 4rem;
+  }
+
+  .loading {
+    text-align: center;
+    color: var(--color-text-muted);
+    padding: 2rem;
+  }
+
+  .alternative-install {
+    max-width: 900px;
+    margin: 0 auto;
+  }
+
+  .alternative-install h2 {
+    text-align: center;
+    margin-bottom: 2rem;
+  }
+
+  .install-options {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+    gap: 1.5rem;
+  }
+
+  .install-option {
+    background: var(--color-bg-secondary);
+    border: 1px solid var(--color-border);
+    border-radius: 12px;
+    padding: 1.5rem;
+  }
+
+  .install-option h3 {
+    color: var(--color-cyan);
+    margin-bottom: 0.5rem;
+  }
+
+  .install-option p {
+    color: var(--color-text-muted);
+    font-size: 0.875rem;
+    margin-bottom: 1rem;
+  }
+
+  .install-command {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    background: var(--color-bg-tertiary);
+    border: 1px solid var(--color-border);
+    border-radius: 6px;
+    padding: 0.5rem 0.75rem;
+    margin-bottom: 0.5rem;
+  }
+
+  .install-command:last-child {
+    margin-bottom: 0;
+  }
+
+  .install-command code {
+    flex: 1;
+    background: none;
+    color: var(--color-cyan);
+    font-size: 0.8rem;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+  }
+
+  .copy-btn {
+    background: none;
+    border: none;
+    color: var(--color-text-muted);
+    cursor: pointer;
+    padding: 4px;
+    display: flex;
+    flex-shrink: 0;
+    transition: color 0.2s;
+  }
+
+  .copy-btn:hover { color: var(--color-text); }
+  .copy-btn.copied { color: var(--color-cyan); }
+</style>
+