You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@magpie.apache.org by po...@apache.org on 2026/06/27 21:32:44 UTC
(magpie-site) 01/01: Refresh content from apache/magpie + publish to magpie.apache.org
This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch refresh/magpie-content-asf-publish
in repository https://gitbox.apache.org/repos/asf/magpie-site.git
commit c91d2390fff8a2ea6de5391e7d767e8538280ada
Author: Jarek Potiuk <ja...@potiuk.com>
AuthorDate: Sat Jun 27 17:29:49 2026 -0400
Refresh content from apache/magpie + publish to magpie.apache.org
Content refresh (latest apache/magpie main):
- Rename apache/airflow-steward -> apache/magpie everywhere (links,
sync source, CI, .gitignore)
- Correct mode statuses on the Features page to match docs/modes.md:
Triage stable, Mentoring experimental, Drafting stable (security),
Pairing experimental, Auto-merge off
- Add a "7 Skill Families" section (setup, security, pr-management,
issue, release-management, mentoring, utilities)
- Rebuild the security section around the real privacy/security posture
(sandbox, privacy-aware routing, PII redaction, audit log, pinned deps,
human-in-the-loop)
- Status badge -> "Apache Top-Level Project"; refreshed hero copy
- Equal-height cards (auto-rows-fr) for the families and security grids;
uniform hero pipeline boxes
- Docs: hide the internal board-resolution draft, lead with a Quick Start
Deployment:
- Publish to magpie.apache.org via ASF infra: CI force-pushes the build
to a `publish` branch; add .asf.yaml (publish.whoami=publish,
hostname=magpie.apache.org)
- Serve at the apex root: base '/', site https://magpie.apache.org
(env-overridable via SITE_BASE / SITE_URL)
Generated-by: Claude Opus 4.8 (1M context)
---
.asf.yaml | 25 +++
.github/workflows/build.yml | 41 ++--
.gitignore | 2 +-
README.md | 32 +--
astro.config.mjs | 9 +-
scripts/sync-docs.sh | 4 +-
src/components/landing/ImmersiveGradientHero.tsx | 260 ++++++++++++++++-------
src/components/landing/SiteFooter.tsx | 12 +-
src/components/landing/SiteHeader.tsx | 6 +-
src/layouts/DocsLayout.astro | 16 +-
src/pages/docs/[...slug].astro | 12 +-
src/pages/docs/index.astro | 38 +++-
12 files changed, 313 insertions(+), 144 deletions(-)
diff --git a/.asf.yaml b/.asf.yaml
new file mode 100644
index 0000000..1935021
--- /dev/null
+++ b/.asf.yaml
@@ -0,0 +1,25 @@
+# Apache Software Foundation repository configuration.
+# https://cwiki.apache.org/confluence/display/INFRA/Git+-+.asf.yaml+features
+#
+# The `github:` block below is applied from the default branch (main).
+# The `publish:` block is what serves the website: ASF infra publishes the
+# branch named in `whoami` to the given hostname. CI builds the site and
+# force-pushes the generated output (this file included) to the `publish`
+# branch, where `whoami: publish` matches and the site goes live at
+# https://magpie.apache.org/. On `main`, `whoami` does not match the branch
+# name, so nothing is published from here.
+
+github:
+ description: "Website for Apache Magpie — agent-assisted repository maintainership and development."
+ homepage: https://magpie.apache.org/
+ labels:
+ - apache
+ - magpie
+ - website
+ - astro
+ features:
+ issues: true
+
+publish:
+ whoami: publish
+ hostname: magpie.apache.org
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index fd64e9c..97ab8db 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -9,17 +9,17 @@ on:
permissions:
contents: read
- pages: write
- id-token: write
concurrency:
- group: pages
+ group: build-${{ github.ref }}
cancel-in-progress: false
jobs:
build:
runs-on: ubuntu-latest
timeout-minutes: 10
+ permissions:
+ contents: write # needed to push the built site to the `publish` branch
steps:
- name: Checkout
uses: actions/checkout@v4
@@ -33,9 +33,9 @@ jobs:
- name: Install dependencies
run: npm ci
- - name: Sync docs from apache/airflow-steward
+ - name: Sync docs from apache/magpie
env:
- MAGPIE_DOCS_REPO: https://github.com/apache/airflow-steward.git
+ MAGPIE_DOCS_REPO: https://github.com/apache/magpie.git
MAGPIE_DOCS_BRANCH: main
run: npm run sync-docs
@@ -46,20 +46,19 @@ jobs:
- name: Build
run: npm run build
- - name: Upload Pages artifact
+ - name: Publish site to "publish" branch
if: github.ref == 'refs/heads/main'
- uses: actions/upload-pages-artifact@v3
- with:
- path: dist
-
- deploy:
- if: github.ref == 'refs/heads/main'
- needs: build
- runs-on: ubuntu-latest
- environment:
- name: github-pages
- url: ${{ steps.deployment.outputs.page_url }}
- steps:
- - name: Deploy to GitHub Pages
- id: deployment
- uses: actions/deploy-pages@v4
+ env:
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ run: |
+ # Carry the ASF publish config into the generated branch so infra
+ # serves it at https://magpie.apache.org/ (whoami: publish).
+ cp .asf.yaml dist/.asf.yaml
+ cd dist
+ git init -q
+ git checkout -q -b publish
+ git config user.name "github-actions[bot]"
+ git config user.email "github-actions[bot]@users.noreply.github.com"
+ git add -A
+ git commit -q -m "Publish site (${GITHUB_SHA::7})"
+ git push -f "https://x-access-token:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git" publish
diff --git a/.gitignore b/.gitignore
index be2da54..3469968 100644
--- a/.gitignore
+++ b/.gitignore
@@ -36,6 +36,6 @@ pnpm-debug.log*
CLAUDE.md
**/settings.local.json
**/scheduled_tasks.lock
-.apache-steward/
+.apache-magpie/
docs/superpowers/
.subframe/
diff --git a/README.md b/README.md
index 0ca7270..c3f80c9 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,8 @@
# Apache Magpie — Website
-Landing page and documentation hub for [Apache Magpie](https://github.com/apache/airflow-steward), an AI-powered assistant that helps open-source maintainers manage contributions more efficiently.
+Landing page and documentation hub for [Apache Magpie](https://github.com/apache/magpie), an AI assistant that helps open-source maintainers handle the repetitive parts of running a project — triage, mentoring, drafting fixes, and security-report handling — so they can focus on the work that needs a human.
-> Status: **incubating** under the Apache Software Foundation. Project source lives at [apache/airflow-steward](https://github.com/apache/airflow-steward); this repo holds the public website.
+> Status: **Apache Top-Level Project**. Project source lives at [apache/magpie](https://github.com/apache/magpie); this repo holds the public website.
## Stack
@@ -12,7 +12,7 @@ Landing page and documentation hub for [Apache Magpie](https://github.com/apache
| UI | React 19 + [Tailwind CSS 4](https://tailwindcss.com) |
| Animations | [Magic UI](https://magicui.design) (Particles, BorderBeam, BlurFade, TextAnimate, ShimmerButton) via `motion` |
| Icons | [lucide-react](https://lucide.dev) + inline SVG for brand marks |
-| Docs | Astro content collections, markdown synced from [apache/airflow-steward/docs](https://github.com/apache/airflow-steward/tree/main/docs) |
+| Docs | Astro content collections, markdown synced from [apache/magpie/docs](https://github.com/apache/magpie/tree/main/docs) |
Zero runtime dependency on closed-source design tooling. All components are owned in-tree.
@@ -20,7 +20,7 @@ Zero runtime dependency on closed-source design tooling. All components are owne
```bash
npm install
-npm run sync-docs # one-time fetch of markdown from apache/airflow-steward
+npm run sync-docs # one-time fetch of markdown from apache/magpie
npm run dev # http://localhost:4321
```
@@ -31,7 +31,7 @@ The `prebuild` hook runs `sync-docs` automatically, so `npm run build` always pu
| Command | Purpose |
|---|---|
| `npm run dev` | Dev server with HMR |
-| `npm run sync-docs` | Clone `apache/airflow-steward` (sparse, `docs/` + `images/`) into `src/content/docs/` and `public/docs-assets/` |
+| `npm run sync-docs` | Clone `apache/magpie` (sparse, `docs/` + `images/`) into `src/content/docs/` and `public/docs-assets/` |
| `npm run build` | Static build to `dist/` (runs sync-docs first) |
| `npm run preview` | Serve the built site locally |
| `npm run astro` | Astro CLI passthrough |
@@ -40,7 +40,7 @@ The `prebuild` hook runs `sync-docs` automatically, so `npm run build` always pu
| Var | Default | Purpose |
|---|---|---|
-| `MAGPIE_DOCS_REPO` | `https://github.com/apache/airflow-steward.git` | Source repo for markdown |
+| `MAGPIE_DOCS_REPO` | `https://github.com/apache/magpie.git` | Source repo for markdown |
| `MAGPIE_DOCS_BRANCH` | `main` | Branch to sync from |
## Project structure
@@ -76,10 +76,10 @@ website/
## Docs pipeline
-The website is decoupled from the docs source. The markdown lives in [apache/airflow-steward/docs](https://github.com/apache/airflow-steward/tree/main/docs); this repo fetches it at build time and renders it through Astro content collections.
+The website is decoupled from the docs source. The markdown lives in [apache/magpie/docs](https://github.com/apache/magpie/tree/main/docs); this repo fetches it at build time and renders it through Astro content collections.
```
-apache/airflow-steward/docs/*.md
+apache/magpie/docs/*.md
│
▼ scripts/sync-docs.sh (sparse clone)
src/content/docs/*.md
@@ -98,15 +98,23 @@ GitHub Actions workflow `.github/workflows/build.yml` runs on every push and PR
2. Sync docs from the source repo
3. `astro check` (warn-only)
4. `astro build`
-5. Deploy to GitHub Pages (on `main`)
+5. On `main`: copy `.asf.yaml` into `dist/` and force-push the build to the `publish` branch
## Deployment
-The site deploys to GitHub Pages on every push to `main`. Production URL:
+The site is published by **ASF infrastructure**, not GitHub Pages. On every push to `main`, CI builds the static site and force-pushes `dist/` (an orphan, single-commit history) to the **`publish`** branch. The root [`.asf.yaml`](./.asf.yaml) — carried into that branch — tells ASF infra to serve it:
-**[andreahlert.github.io/magpie-site](https://andreahlert.github.io/magpie-site/)**
+```yaml
+publish:
+ whoami: publish
+ hostname: magpie.apache.org
+```
+
+Production URL: **[magpie.apache.org](https://magpie.apache.org/)** (served at the apex root).
+
+The site is built with `base: '/'` so all links and assets resolve against the apex domain. Set `SITE_BASE` / `SITE_URL` to preview under a subpath (e.g. GitHub Pages).
-When this repo moves to `apache/magpie-site`, the deploy target will switch to the ASF `asf-site` branch served by Apache infra at `magpie.apache.org`.
+> One-time infra setup (outside this repo): the `magpie.apache.org` hostname and its TLS must be registered with ASF Infra, and the `publish` branch created on first CI run.
## License
diff --git a/astro.config.mjs b/astro.config.mjs
index 67f9645..7f6b6a5 100644
--- a/astro.config.mjs
+++ b/astro.config.mjs
@@ -3,10 +3,15 @@ import { defineConfig } from 'astro/config';
import react from '@astrojs/react';
import tailwindcss from '@tailwindcss/vite';
+// Production is served directly at the apex https://magpie.apache.org/ (root path).
+// Override SITE_URL / SITE_BASE if you ever need to preview under a subpath.
+const site = process.env.SITE_URL ?? 'https://magpie.apache.org';
+const base = process.env.SITE_BASE ?? '/';
+
// https://astro.build/config
export default defineConfig({
- site: 'https://andreahlert.github.io',
- base: '/magpie-site',
+ site,
+ base,
integrations: [react()],
vite: {
plugins: [tailwindcss()],
diff --git a/scripts/sync-docs.sh b/scripts/sync-docs.sh
index 220ab28..b484bb0 100755
--- a/scripts/sync-docs.sh
+++ b/scripts/sync-docs.sh
@@ -1,9 +1,9 @@
#!/usr/bin/env bash
-# Sync docs from apache/airflow-steward into src/content/docs/
+# Sync docs from apache/magpie into src/content/docs/
# Runs as prebuild step and locally via `npm run sync-docs`.
set -euo pipefail
-REPO="${MAGPIE_DOCS_REPO:-https://github.com/apache/airflow-steward.git}"
+REPO="${MAGPIE_DOCS_REPO:-https://github.com/apache/magpie.git}"
BRANCH="${MAGPIE_DOCS_BRANCH:-main}"
DEST="$(dirname "$0")/../src/content/docs"
diff --git a/src/components/landing/ImmersiveGradientHero.tsx b/src/components/landing/ImmersiveGradientHero.tsx
index e23110b..d427aa2 100644
--- a/src/components/landing/ImmersiveGradientHero.tsx
+++ b/src/components/landing/ImmersiveGradientHero.tsx
@@ -29,9 +29,7 @@ import {
Lock as FeatherLock,
Menu as FeatherMenu,
PenTool as FeatherPenTool,
- RefreshCw as FeatherRefreshCw,
Shield as FeatherShield,
- Users as FeatherUsers,
} from "lucide-react";
const FeatherGithub = (props: React.SVGProps<SVGSVGElement>) => (
@@ -52,6 +50,58 @@ const FeatherSlack = (props: React.SVGProps<SVGSVGElement>) => (
</svg>
);
+const SKILL_FAMILIES = [
+ {
+ name: "setup",
+ icon: FeatherLayers,
+ modes: "Infrastructure",
+ count: "6 skills",
+ desc: "Isolated agent setup, framework adoption & maintenance, shared-config sync. The prerequisite every adopter starts from.",
+ },
+ {
+ name: "security",
+ icon: FeatherShield,
+ modes: "Triage · Drafting",
+ count: "9 skills",
+ desc: "The 16-step security-issue lifecycle — from security@ import through CVE allocation and publication, with state sync. Maintainer-only.",
+ },
+ {
+ name: "pr-management",
+ icon: FeatherGitPullRequest,
+ modes: "Triage",
+ count: "3 skills",
+ desc: "Maintainer-facing PR-queue management — triage, queue stats, and deep code review.",
+ },
+ {
+ name: "issue",
+ icon: FeatherFilter,
+ modes: "Triage · Drafting",
+ count: "5 skills",
+ desc: "Issue lifecycle — triage, bug reproduction, fix drafting, and backlog re-assessment against the current branch.",
+ },
+ {
+ name: "release-management",
+ icon: FeatherGitMerge,
+ modes: "Triage · Drafting",
+ count: "10 skills · proposed",
+ desc: "The 14-step ASF release lifecycle — planning, RC cut & sign, [VOTE], tally, promote, [ANNOUNCE], archive, audit. The agent never holds the signing key or publishes.",
+ },
+ {
+ name: "mentoring",
+ icon: FeatherBookOpen,
+ modes: "Mentoring",
+ count: "1 skill · experimental",
+ desc: "Contributor mentoring — spec and tone guide in place; first skill (pr-management-mentor) shipping.",
+ },
+ {
+ name: "utilities",
+ icon: FeatherPenTool,
+ modes: "Meta",
+ count: "2 skills",
+ desc: "Framework meta-skills — author or update skills (write-skill) and print a live index of every skill (list-skills).",
+ },
+];
+
function ImmersiveGradientHero() {
return (
<div className="flex h-full w-full flex-col items-center bg-default-background">
@@ -79,11 +129,11 @@ function ImmersiveGradientHero() {
<div className="flex items-center gap-7 mobile:hidden">
<a className="text-body font-body text-brand-600 hover:text-brand-700" href="#features">Features</a>
<a className="text-body font-body text-brand-600 hover:text-brand-700" href={withBase("/docs")}>Docs</a>
- <a className="text-body font-body text-brand-600 hover:text-brand-700" href="https://lists.apache.org/list.html?dev-magpie@airflow.apache.org">Community</a>
- <a className="text-body font-body text-brand-600 hover:text-brand-700" href="https://github.com/apache/airflow-steward">GitHub</a>
+ <a className="text-body font-body text-brand-600 hover:text-brand-700" href="https://lists.apache.org/list.html?dev@magpie.apache.org">Community</a>
+ <a className="text-body font-body text-brand-600 hover:text-brand-700" href="https://github.com/apache/magpie">GitHub</a>
</div>
<div className="flex items-center gap-2">
- <a href="https://github.com/apache/airflow-steward" target="_blank" rel="noreferrer" className="mobile:hidden">
+ <a href="https://github.com/apache/magpie" target="_blank" rel="noreferrer" className="mobile:hidden">
<Button
className="border border-white/20 bg-white/10 text-white hover:bg-white/20"
variant="neutral-secondary"
@@ -107,7 +157,7 @@ function ImmersiveGradientHero() {
<div className="flex items-center gap-2 rounded-full px-4 py-1.5 border border-brand-400/40 bg-brand-700/60">
<FeatherFeather className="text-caption font-caption text-brand-200" />
<span className="text-caption font-caption text-brand-200">
- Apache Software Foundation Incubating
+ Apache Top-Level Project
</span>
</div>
<div className="flex flex-col items-start gap-5">
@@ -122,10 +172,12 @@ function ImmersiveGradientHero() {
</TextAnimate>
<BlurFade delay={0.4} inView>
<span className="font-['Inter'] text-[17px] font-[400] leading-[27px] text-brand-200 -tracking-[0.01em]">
- Apache Magpie is an AI-powered assistant that helps open-source
- maintainers manage contributions more efficiently. From triage
- to auto-merge, Magpie learns your project and scales your review
- capacity.
+ Apache Magpie handles the repetitive parts of running an
+ open-source project — triaging issues and PRs, mentoring
+ contributors, drafting fixes, managing security reports — so
+ maintainers can spend their time on design, relationships, and
+ the work that needs a human. The agent proposes; the human
+ decides.
</span>
</BlurFade>
</div>
@@ -175,7 +227,7 @@ function ImmersiveGradientHero() {
<div className="flex grow shrink-0 basis-0 flex-col items-center justify-center self-stretch rounded-2xl border border-solid border-[#b3d1ff] bg-[#f0f5ff] px-8 py-8 min-w-[380px]">
<div className="flex w-full flex-col items-center py-4">
<div className="flex w-full flex-col items-center">
- <div className="flex w-full items-center gap-3 rounded-xl border border-solid border-[#80b3ff] bg-white px-5 py-3 shadow-md max-w-[360px]">
+ <div className="flex min-h-[76px] w-full items-center gap-3 rounded-xl border border-solid border-[#80b3ff] bg-white px-5 py-3 shadow-md max-w-[360px]">
<div className="flex h-10 w-10 flex-none items-center justify-center rounded-full bg-[#e6f0ff]">
<FeatherGitPullRequest className="text-heading-3 font-heading-3 text-[#004aad]" />
</div>
@@ -196,7 +248,7 @@ function ImmersiveGradientHero() {
</div>
</div>
<div className="flex w-full flex-col items-center">
- <div className="flex w-full items-center gap-3 rounded-xl border border-solid border-[#80b3ff] bg-white px-5 py-3 shadow-md max-w-[360px]">
+ <div className="flex min-h-[76px] w-full items-center gap-3 rounded-xl border border-solid border-[#80b3ff] bg-white px-5 py-3 shadow-md max-w-[360px]">
<div className="flex h-10 w-10 flex-none items-center justify-center rounded-full bg-[#e6f0ff]">
<FeatherFilter className="text-heading-3 font-heading-3 text-[#004aad]" />
</div>
@@ -209,7 +261,7 @@ function ImmersiveGradientHero() {
</span>
</div>
<Badge variant="success" icon={<FeatherCheck />}>
- Active
+ Stable
</Badge>
</div>
<div className="flex flex-col items-center py-1">
@@ -217,7 +269,7 @@ function ImmersiveGradientHero() {
</div>
</div>
<div className="flex w-full flex-col items-center">
- <div className="flex w-full items-center gap-3 rounded-xl border border-solid border-[#80b3ff] bg-white px-5 py-3 shadow-md max-w-[360px]">
+ <div className="flex min-h-[76px] w-full items-center gap-3 rounded-xl border border-solid border-[#80b3ff] bg-white px-5 py-3 shadow-md max-w-[360px]">
<div className="flex h-10 w-10 flex-none items-center justify-center rounded-full bg-[#e6f0ff]">
<FeatherBookOpen className="text-heading-3 font-heading-3 text-[#004aad]" />
</div>
@@ -229,8 +281,8 @@ function ImmersiveGradientHero() {
Guide contributors with feedback
</span>
</div>
- <Badge variant="success" icon={<FeatherCheck />}>
- Active
+ <Badge variant="warning" icon={<FeatherClock />}>
+ Experimental
</Badge>
</div>
<div className="flex flex-col items-center py-1">
@@ -238,7 +290,7 @@ function ImmersiveGradientHero() {
</div>
</div>
<div className="flex w-full flex-col items-center">
- <div className="flex w-full items-center gap-3 rounded-xl border border-solid border-[#b3d1ff] bg-white px-5 py-3 shadow-md max-w-[360px]">
+ <div className="flex min-h-[76px] w-full items-center gap-3 rounded-xl border border-solid border-[#b3d1ff] bg-white px-5 py-3 shadow-md max-w-[360px]">
<div className="flex h-10 w-10 flex-none items-center justify-center rounded-full bg-[#e6f0ff]">
<FeatherPenTool className="text-heading-3 font-heading-3 text-[#004aad]" />
</div>
@@ -250,8 +302,8 @@ function ImmersiveGradientHero() {
Generate review comments & notes
</span>
</div>
- <Badge variant="warning" icon={<FeatherClock />}>
- Beta
+ <Badge variant="success" icon={<FeatherCheck />}>
+ Stable
</Badge>
</div>
<div className="flex flex-col items-center py-1">
@@ -259,21 +311,21 @@ function ImmersiveGradientHero() {
</div>
</div>
<div className="flex w-full flex-col items-center">
- <div className="relative flex w-full items-center gap-3 rounded-xl border-2 border-solid border-[#004aad] px-5 py-4 shadow-lg bg-gradient-to-br from-[#e6f0ff] to-[#b3d1ff] max-w-[360px] overflow-hidden">
+ <div className="relative flex min-h-[76px] w-full items-center gap-3 rounded-xl border border-solid border-[#004aad] px-5 py-3 shadow-md bg-gradient-to-br from-[#e6f0ff] to-[#b3d1ff] max-w-[360px] overflow-hidden">
<BorderBeam size={120} duration={6} colorFrom="#004aad" colorTo="#80b3ff" />
- <div className="flex h-12 w-12 flex-none items-center justify-center rounded-full bg-[#004aad] shadow-sm">
- <FeatherGitMerge className="text-heading-2 font-heading-2 text-white" />
+ <div className="flex h-10 w-10 flex-none items-center justify-center rounded-full bg-[#004aad] shadow-sm">
+ <FeatherGitMerge className="text-heading-3 font-heading-3 text-white" />
</div>
<div className="flex grow shrink-0 basis-0 flex-col items-start">
<span className="text-body-bold font-body-bold text-[#002654]">
Auto-merge
</span>
<span className="text-caption font-caption text-[#004aad]">
- Merge when all checks pass
+ Off by design until earlier modes prove out
</span>
</div>
<Badge variant="neutral" icon={<FeatherLock />}>
- Planned
+ Off
</Badge>
</div>
</div>
@@ -312,7 +364,7 @@ function ImmersiveGradientHero() {
Triage Mode
</span>
<Badge variant="success" icon={<FeatherCheck />}>
- Active
+ Stable
</Badge>
</div>
<span className="text-body font-body text-subtext-color">
@@ -337,16 +389,16 @@ function ImmersiveGradientHero() {
Mentoring Mode
</span>
<Badge variant="warning" icon={<FeatherClock />}>
- Beta
+ Experimental
</Badge>
</div>
<span className="text-body font-body text-subtext-color">
- Guide first-time contributors with contextual suggestions and
- code style feedback.
+ Joins issue and PR threads in a teaching register — clarifying
+ questions, pointers to conventions, examples from prior PRs.
</span>
<div className="flex flex-wrap items-start gap-2 pt-1">
- <Badge variant="neutral">Style guides</Badge>
- <Badge variant="neutral">Doc links</Badge>
+ <Badge variant="neutral">Conventions</Badge>
+ <Badge variant="neutral">Prior PRs</Badge>
</div>
</div>
</div>
@@ -364,16 +416,16 @@ function ImmersiveGradientHero() {
Drafting Mode
</span>
<Badge variant="success" icon={<FeatherCheck />}>
- Active
+ Stable (security)
</Badge>
</div>
<span className="text-body font-body text-subtext-color">
- Generate review comments, changelogs, and release notes from
- PR context and commit history.
+ Draft a fix for a well-scoped problem and open a PR — every PR
+ reviewed and merged by a human committer, never the agent.
</span>
<div className="flex flex-wrap items-start gap-2 pt-1">
- <Badge variant="neutral">Review drafts</Badge>
- <Badge variant="neutral">Changelogs</Badge>
+ <Badge variant="neutral">Fix PRs</Badge>
+ <Badge variant="neutral">Human-merged</Badge>
</div>
</div>
</div>
@@ -389,16 +441,16 @@ function ImmersiveGradientHero() {
Pairing Mode
</span>
<Badge variant="warning" icon={<FeatherClock />}>
- Beta
+ Experimental
</Badge>
</div>
<span className="text-body font-body text-subtext-color">
- Work alongside maintainers in real-time, suggesting fixes and
- identifying edge cases before review.
+ Developer-side skills you run in your own dev loop — multi-agent
+ review pipelines and self-review before you open a PR.
</span>
<div className="flex flex-wrap items-start gap-2 pt-1">
- <Badge variant="neutral">Real-time assist</Badge>
- <Badge variant="neutral">Pre-checks</Badge>
+ <Badge variant="neutral">Self-review</Badge>
+ <Badge variant="neutral">Pre-flight</Badge>
</div>
</div>
</div>
@@ -416,13 +468,14 @@ function ImmersiveGradientHero() {
Auto-merge Mode
</span>
<Badge variant="neutral" icon={<FeatherLock />}>
- Planned
+ Off
</Badge>
</div>
<span className="text-body font-body text-subtext-color max-w-[640px]">
- For trusted, well-tested contributions that pass all checks,
- Magpie can autonomously approve and merge with full audit trails
- and rollback capability.
+ Narrowly-scoped fix-and-merge for objectively boring changes —
+ lint, allow-listed dependency bumps, formatting. Deliberately
+ off until the earlier modes have proven out, and never for
+ security-class changes.
</span>
<div className="flex flex-wrap items-start gap-2 pt-1">
<Badge variant="brand">Auto-approve</Badge>
@@ -434,6 +487,49 @@ function ImmersiveGradientHero() {
</div>
</div>
</div>
+ <div id="skills" className="flex w-full flex-col items-center bg-default-background px-8 pb-24 mobile:px-4 mobile:pb-14">
+ <BlurFade inView className="flex flex-col items-center gap-4 max-w-[640px] pb-12 mobile:pb-8">
+ <div className="flex items-center gap-2 rounded-full border border-solid border-brand-200 bg-brand-50 px-4 py-1.5">
+ <FeatherLayers className="text-caption font-caption text-brand-600" />
+ <span className="text-caption font-caption text-brand-600">
+ 7 Skill Families
+ </span>
+ </div>
+ <span className="font-['Inter'] text-[38px] font-[700] leading-[44px] text-default-font text-center -tracking-[0.035em] mobile:font-['Jost'] mobile:text-[28px] mobile:font-[400] mobile:leading-[34px] mobile:tracking-normal">
+ Pick the families your project needs
+ </span>
+ <span className="text-body font-body text-subtext-color text-center">
+ Modes describe what the agent can do; skill families are how those
+ capabilities ship. Adopt only the families that fit — symlinks for
+ the picked families land in your skill directory.
+ </span>
+ </BlurFade>
+ <div className="w-full items-stretch gap-4 grid grid-cols-3 auto-rows-fr max-w-[1100px] mobile:grid-cols-1">
+ {SKILL_FAMILIES.map((family) => {
+ const Icon = family.icon;
+ return (
+ <div
+ key={family.name}
+ className="flex h-full flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm hover:border-brand-200 hover:shadow-md transition-all"
+ >
+ <div className="flex w-full items-center justify-between">
+ <div className="flex h-10 w-10 flex-none items-center justify-center rounded-xl bg-brand-100">
+ <Icon className="text-body-bold font-body-bold text-brand-700" />
+ </div>
+ <Badge variant="neutral">{family.count}</Badge>
+ </div>
+ <span className="font-mono text-body-bold font-body-bold text-default-font">
+ {family.name}
+ </span>
+ <Badge variant="brand">{family.modes}</Badge>
+ <span className="text-caption font-caption text-subtext-color">
+ {family.desc}
+ </span>
+ </div>
+ );
+ })}
+ </div>
+ </div>
<div className="flex w-full flex-col items-center border-y border-solid border-neutral-100 bg-neutral-50">
<div className="flex w-full flex-col items-center gap-14 px-8 py-24 max-w-[1100px] mobile:gap-8 mobile:px-4 mobile:py-14">
<div className="flex flex-col items-center gap-4 max-w-[600px]">
@@ -451,77 +547,77 @@ function ImmersiveGradientHero() {
every action respects the principle of least privilege.
</span>
</div>
- <div className="w-full items-start gap-4 grid grid-cols-3 mobile:grid mobile:grid-cols-1">
- <div className="flex flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
+ <div className="w-full items-stretch gap-4 grid grid-cols-3 auto-rows-fr mobile:grid mobile:grid-cols-1">
+ <div className="flex h-full flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
<div className="flex h-10 w-10 flex-none items-center justify-center rounded-xl bg-brand-100">
- <FeatherKey className="text-body-bold font-body-bold text-brand-700" />
+ <FeatherShield className="text-body-bold font-body-bold text-brand-700" />
</div>
<span className="text-body-bold font-body-bold text-default-font">
- Token Scoping
+ Sandboxed by Default
</span>
<span className="text-caption font-caption text-subtext-color">
- Minimal permissions per operation. Magpie never requests more
- access than needed.
+ Filesystem, network, and tool-permission rules enforced at the
+ harness layer. Sandbox bypasses warn loudly, never silently.
</span>
</div>
- <div className="flex flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
+ <div className="flex h-full flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
<div className="flex h-10 w-10 flex-none items-center justify-center rounded-xl bg-brand-100">
- <FeatherFileText className="text-body-bold font-body-bold text-brand-700" />
+ <FeatherLock className="text-body-bold font-body-bold text-brand-700" />
</div>
<span className="text-body-bold font-body-bold text-default-font">
- Full Audit Logs
+ Privacy-Aware Routing
</span>
<span className="text-caption font-caption text-subtext-color">
- Every AI decision logged with reasoning, context, and
- timestamps. Full traceability.
+ Private content flows only to LLMs your PMC has explicitly
+ approved, with a recorded data-residency contract.
</span>
</div>
- <div className="flex flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
+ <div className="flex h-full flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
<div className="flex h-10 w-10 flex-none items-center justify-center rounded-xl bg-brand-100">
<FeatherEyeOff className="text-body-bold font-body-bold text-brand-700" />
</div>
<span className="text-body-bold font-body-bold text-default-font">
- No Data Retention
+ PII Redaction
</span>
<span className="text-caption font-caption text-subtext-color">
- Code processed in-memory, never stored. Your intellectual
- property stays yours.
+ Third-party PII is redacted to stable identifiers before any
+ content reaches an LLM context.
</span>
</div>
- <div className="flex flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
+ <div className="flex h-full flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
<div className="flex h-10 w-10 flex-none items-center justify-center rounded-xl bg-brand-100">
- <FeatherRefreshCw className="text-body-bold font-body-bold text-brand-700" />
+ <FeatherFileText className="text-body-bold font-body-bold text-brand-700" />
</div>
<span className="text-body-bold font-body-bold text-default-font">
- Rollback Support
+ Full Audit Log
</span>
<span className="text-caption font-caption text-subtext-color">
- Any automated action can be instantly reversed. Humans always
- retain the final say.
+ Every agent-authored action — comment, label, draft, PR — is
+ logged and reversible where possible.
</span>
</div>
- <div className="flex flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
+ <div className="flex h-full flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
<div className="flex h-10 w-10 flex-none items-center justify-center rounded-xl bg-brand-100">
- <FeatherUsers className="text-body-bold font-body-bold text-brand-700" />
+ <FeatherKey className="text-body-bold font-body-bold text-brand-700" />
</div>
<span className="text-body-bold font-body-bold text-default-font">
- Role-Based Access
+ Pinned & Signed Deps
</span>
<span className="text-caption font-caption text-subtext-color">
- Granular permissions aligned with project governance. Distinct
- access for PMC and contributors.
+ Every system tool is pinned and aged through a cooldown window.
+ Version bumps are reviewed PRs, not silent updates.
</span>
</div>
- <div className="flex flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
+ <div className="flex h-full flex-col items-start gap-3 rounded-2xl border border-solid border-neutral-200 bg-default-background px-5 py-5 shadow-sm">
<div className="flex h-10 w-10 flex-none items-center justify-center rounded-xl bg-brand-100">
- <FeatherShield className="text-body-bold font-body-bold text-brand-700" />
+ <FeatherCheckCircle className="text-body-bold font-body-bold text-brand-700" />
</div>
<span className="text-body-bold font-body-bold text-default-font">
- ASF Compliance
+ Human-in-the-Loop
</span>
<span className="text-caption font-caption text-subtext-color">
- Built to meet Apache Software Foundation standards for security
- and governance.
+ Every outward action needs explicit maintainer confirmation.
+ External content is treated as data, never instructions.
</span>
</div>
</div>
@@ -608,10 +704,10 @@ function ImmersiveGradientHero() {
<div className="flex flex-wrap items-center justify-center gap-3">
<a href={withBase("/docs")}>
<Button size="large" icon={<FeatherArrowRight />}>
- Get Started Free
+ Get Started
</Button>
</a>
- <a href="https://github.com/apache/airflow-steward" target="_blank" rel="noreferrer">
+ <a href="https://github.com/apache/magpie" target="_blank" rel="noreferrer">
<Button
className="border border-white/20 bg-white/10 text-white hover:bg-white/20"
size="large"
@@ -636,7 +732,7 @@ function ImmersiveGradientHero() {
open-source maintainers.
</span>
<div className="flex items-center gap-2">
- <a href="https://github.com/apache/airflow-steward" target="_blank" rel="noreferrer" aria-label="GitHub">
+ <a href="https://github.com/apache/magpie" target="_blank" rel="noreferrer" aria-label="GitHub">
<IconButton icon={<FeatherGithub />} />
</a>
<a href="https://twitter.com/TheASF" target="_blank" rel="noreferrer" aria-label="Twitter">
@@ -652,15 +748,15 @@ function ImmersiveGradientHero() {
<span className="text-body-bold font-body-bold text-default-font">Project</span>
<a className="text-body font-body text-subtext-color hover:text-brand-600" href="#features">Features</a>
<a className="text-body font-body text-subtext-color hover:text-brand-600" href={withBase("/docs")}>Documentation</a>
- <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/airflow-steward/issues">Roadmap</a>
- <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/airflow-steward/releases">Changelog</a>
+ <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/magpie/issues">Roadmap</a>
+ <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/magpie/releases">Changelog</a>
</div>
<div className="flex grow shrink-0 basis-0 flex-col items-start gap-3 min-w-[130px]">
<span className="text-body-bold font-body-bold text-default-font">Community</span>
- <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/airflow-steward/blob/main/CONTRIBUTING.md">Contributing</a>
- <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://lists.apache.org/list.html?dev-magpie@airflow.apache.org">Mailing Lists</a>
+ <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/magpie/blob/main/CONTRIBUTING.md">Contributing</a>
+ <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://lists.apache.org/list.html?dev@magpie.apache.org">Mailing Lists</a>
<a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://the-asf.slack.com">Slack Channel</a>
- <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/airflow-steward/issues">Issue Tracker</a>
+ <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/magpie/issues">Issue Tracker</a>
</div>
<div className="flex grow shrink-0 basis-0 flex-col items-start gap-3 min-w-[130px]">
<span className="text-body-bold font-body-bold text-default-font">Foundation</span>
diff --git a/src/components/landing/SiteFooter.tsx b/src/components/landing/SiteFooter.tsx
index 77ab817..d99d03a 100644
--- a/src/components/landing/SiteFooter.tsx
+++ b/src/components/landing/SiteFooter.tsx
@@ -33,7 +33,7 @@ export function SiteFooter() {
open-source maintainers.
</span>
<div className="flex items-center gap-2">
- <a href="https://github.com/apache/airflow-steward" target="_blank" rel="noreferrer" aria-label="GitHub">
+ <a href="https://github.com/apache/magpie" target="_blank" rel="noreferrer" aria-label="GitHub">
<IconButton icon={<GithubIcon />} />
</a>
<a href="https://twitter.com/TheASF" target="_blank" rel="noreferrer" aria-label="Twitter">
@@ -49,15 +49,15 @@ export function SiteFooter() {
<span className="text-body-bold font-body-bold text-default-font">Project</span>
<a className="text-body font-body text-subtext-color hover:text-brand-600" href={`${withBase("/")}#features`}>Features</a>
<a className="text-body font-body text-subtext-color hover:text-brand-600" href={withBase("/docs")}>Documentation</a>
- <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/airflow-steward/issues">Roadmap</a>
- <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/airflow-steward/releases">Changelog</a>
+ <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/magpie/issues">Roadmap</a>
+ <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/magpie/releases">Changelog</a>
</div>
<div className="flex grow shrink-0 basis-0 flex-col items-start gap-3 min-w-[130px]">
<span className="text-body-bold font-body-bold text-default-font">Community</span>
- <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/airflow-steward/blob/main/CONTRIBUTING.md">Contributing</a>
- <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://lists.apache.org/list.html?dev-magpie@airflow.apache.org">Mailing Lists</a>
+ <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/magpie/blob/main/CONTRIBUTING.md">Contributing</a>
+ <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://lists.apache.org/list.html?dev@magpie.apache.org">Mailing Lists</a>
<a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://the-asf.slack.com">Slack Channel</a>
- <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/airflow-steward/issues">Issue Tracker</a>
+ <a className="text-body font-body text-subtext-color hover:text-brand-600" href="https://github.com/apache/magpie/issues">Issue Tracker</a>
</div>
<div className="flex grow shrink-0 basis-0 flex-col items-start gap-3 min-w-[130px]">
<span className="text-body-bold font-body-bold text-default-font">Foundation</span>
diff --git a/src/components/landing/SiteHeader.tsx b/src/components/landing/SiteHeader.tsx
index b0b9ebb..c01b276 100644
--- a/src/components/landing/SiteHeader.tsx
+++ b/src/components/landing/SiteHeader.tsx
@@ -36,11 +36,11 @@ export function SiteHeader({ tone = "default" }: { tone?: "default" | "hero" })
<div className="flex items-center gap-7 mobile:hidden">
<a className="text-body font-body text-brand-600 hover:text-brand-700" href={`${withBase("/")}#features`}>Features</a>
<a className="text-body font-body text-brand-600 hover:text-brand-700" href={withBase("/docs")}>Docs</a>
- <a className="text-body font-body text-brand-600 hover:text-brand-700" href="https://lists.apache.org/list.html?dev-magpie@airflow.apache.org">Community</a>
- <a className="text-body font-body text-brand-600 hover:text-brand-700" href="https://github.com/apache/airflow-steward">GitHub</a>
+ <a className="text-body font-body text-brand-600 hover:text-brand-700" href="https://lists.apache.org/list.html?dev@magpie.apache.org">Community</a>
+ <a className="text-body font-body text-brand-600 hover:text-brand-700" href="https://github.com/apache/magpie">GitHub</a>
</div>
<div className="flex items-center gap-2">
- <a href="https://github.com/apache/airflow-steward" target="_blank" rel="noreferrer" className="mobile:hidden">
+ <a href="https://github.com/apache/magpie" target="_blank" rel="noreferrer" className="mobile:hidden">
<Button className={ghBtnClass} variant="neutral-secondary" icon={<GithubIcon />}>
Star on GitHub
</Button>
diff --git a/src/layouts/DocsLayout.astro b/src/layouts/DocsLayout.astro
index bd0aae8..c046a92 100644
--- a/src/layouts/DocsLayout.astro
+++ b/src/layouts/DocsLayout.astro
@@ -10,7 +10,15 @@ interface Props {
}
const { title, currentSlug } = Astro.props;
-const all = await getCollection("docs");
+
+// Internal governance drafts that should not appear on the public site.
+const HIDDEN_DOCS = new Set(["board-resolution-draft"]);
+// Quick-start entry pinned to the top of the docs sidebar.
+const QUICK_START = { slug: "setup/install-recipes", label: "Quick Start" };
+
+const all = (await getCollection("docs")).filter(
+ (entry) => !HIDDEN_DOCS.has(entry.id.replace(/\.md$/, "")),
+);
type NavGroup = { name: string; items: { slug: string; label: string }[] };
const groups = new Map<string, NavGroup>();
@@ -37,6 +45,12 @@ const base = import.meta.env.BASE_URL.replace(/\/$/, "");
<div class="flex w-full">
<aside class="w-64 flex-none border-r border-neutral-200 bg-neutral-50 px-5 py-8 overflow-y-auto sticky top-0 max-h-screen mobile:hidden">
<a href={`${base}/`} class="block mb-6 text-body-bold font-body-bold text-brand-700 hover:text-brand-600">← Back to home</a>
+ <a
+ href={`${base}/docs/${QUICK_START.slug}`}
+ class={`block mb-6 px-3 py-2 rounded-md text-body-bold font-body-bold ${currentSlug === QUICK_START.slug ? "bg-brand-600 text-white" : "bg-brand-50 text-brand-700 hover:bg-brand-100"}`}
+ >
+ ⚡ {QUICK_START.label}
+ </a>
<nav class="flex flex-col gap-6">
{sortedGroups.map((group) => (
<div>
diff --git a/src/pages/docs/[...slug].astro b/src/pages/docs/[...slug].astro
index b404908..832abdc 100644
--- a/src/pages/docs/[...slug].astro
+++ b/src/pages/docs/[...slug].astro
@@ -3,11 +3,15 @@ import { getCollection, render } from "astro:content";
import DocsLayout from "../../layouts/DocsLayout.astro";
export async function getStaticPaths() {
+ // Internal governance drafts that should not appear on the public site.
+ const HIDDEN_DOCS = new Set(["board-resolution-draft"]);
const docs = await getCollection("docs");
- return docs.map((entry) => ({
- params: { slug: entry.id.replace(/\.md$/, "") },
- props: { entry },
- }));
+ return docs
+ .filter((entry) => !HIDDEN_DOCS.has(entry.id.replace(/\.md$/, "")))
+ .map((entry) => ({
+ params: { slug: entry.id.replace(/\.md$/, "") },
+ props: { entry },
+ }));
}
const { entry } = Astro.props;
diff --git a/src/pages/docs/index.astro b/src/pages/docs/index.astro
index 1ad0051..7101446 100644
--- a/src/pages/docs/index.astro
+++ b/src/pages/docs/index.astro
@@ -1,20 +1,38 @@
---
import DocsLayout from "../../layouts/DocsLayout.astro";
-import { getCollection } from "astro:content";
-const all = await getCollection("docs");
-const first = all.find((e) => e.id === "README.md") ?? all[0];
+const base = import.meta.env.BASE_URL.replace(/\/$/, "");
+const QUICK_START = `${base}/docs/setup/install-recipes`;
+const OVERVIEW = `${base}/docs/index`;
---
<DocsLayout title="Documentation" currentSlug="">
<h1>Apache Magpie Documentation</h1>
<p>
- Welcome. Source: <a href="https://github.com/apache/airflow-steward/tree/main/docs">apache/airflow-steward/docs</a>.
+ Apache Magpie is an AI assistant for open-source project maintainers. It
+ handles the repetitive parts of running a project — triaging issues,
+ reviewing PRs, onboarding contributors, managing security reports, cutting
+ releases — so maintainers can spend their time on the work that needs a
+ human. <strong>The agent proposes; the human decides.</strong>
+ </p>
+
+ <h2>Quick Start</h2>
+ <p>
+ Adopt Magpie in your repo with a single copy-pasteable bootstrap, then let
+ the <code>setup</code> skill wire up the rest. Pick an install method and
+ follow the verbatim recipe:
+ </p>
+ <p>
+ <a href={QUICK_START}><strong>⚡ Quick Start → Install recipes</strong></a>
+ ·
+ <a href={`${base}/docs/prerequisites`}>Prerequisites</a>
+ ·
+ <a href={OVERVIEW}>What is Apache Magpie?</a>
+ </p>
+
+ <p>
+ These pages are synced from
+ <a href="https://github.com/apache/magpie/tree/main/docs">apache/magpie/docs</a>.
+ Browse the full set from the sidebar.
</p>
- <p>Pick a topic from the sidebar to get started.</p>
- {first && (
- <p>
- <a href={`${import.meta.env.BASE_URL.replace(/\/$/, "")}/docs/${first.id.replace(/\.md$/, "")}`}>→ Start with {first.id.replace(/\.md$/, "")}</a>
- </p>
- )}
</DocsLayout>