From 9bdd1e9109402615c8eca5bea892ee1cae4f20a9 Mon Sep 17 00:00:00 2001
From: Richard Huang <rhuang@richardmac.local>
Date: Wed, 17 Jun 2026 18:21:59 +0800
Subject: [PATCH] docs: refresh site with latest project momentum

---
 docs/intro.md                                 | 17 +++-
 .../current/intro.md                          | 17 +++-
 src/components/project/project.module.css     |  8 ++
 src/data/generated/project-data.json          | 33 ++++---
 src/pages/index.js                            | 88 +++++++++++++------
 src/pages/project/index.js                    | 62 ++++++++++---
 src/pages/project/releases.js                 | 67 ++++++++++++++
 src/pages/project/roadmap.js                  | 27 +++++-
 8 files changed, 264 insertions(+), 55 deletions(-)

diff --git a/docs/intro.md b/docs/intro.md
index 53d212e..8ecc178 100644
--- a/docs/intro.md
+++ b/docs/intro.md
@@ -6,7 +6,15 @@ description: Open ACE documentation index for deployment, architecture, remote a
 
 # Open ACE Documentation
 
-Open ACE is a self-hosted AI coding agent workspace and governance plane. This documentation site turns the repository docs into a structured entry point for deployers, developers, and platform teams.
+Open ACE is a self-hosted control plane for AI coding agents. It combines browser-based AI coding sessions, Remote Agent execution, autonomous GitHub issue workflows, and governance features for teams that need to run agents on their own machines and credentials.
+
+## What Is New
+
+- Autonomous development workflows can take GitHub issues through planning, implementation, review, and final code-change summaries.
+- Batch issue runs, auto-merge controls, pause/cancel behavior, and fork-from-here flows make agent work easier to operate.
+- Timeline views now expose milestone summaries, full-text output, status semantics, usage counters, and final changes.
+- Remote Agent now covers Claude Code, Qwen Code, Codex, OpenClaw, and ZCode, with token-based registration and management.
+- Docker, package, macOS, source-install, migration, and upgrade paths are being actively hardened.
 
 ## Start With These Guides
 
@@ -22,6 +30,13 @@ Open ACE is a self-hosted AI coding agent workspace and governance plane. This d
 - Platform teams operating remote machines, API key routing, and audit controls
 - Administrators evaluating cost, compliance, and permission boundaries
 
+## Project Status
+
+- [Project overview](/project)
+- [Roadmap](/project/roadmap)
+- [Recent release and PR highlights](/project/releases)
+- [Community entry points](/project/community)
+
 ## Source Of Truth
 
 The canonical Markdown files remain in the repository under `docs/en` and `docs/cn`. The site build syncs those directories into Docusaurus during CI and Pages deployment.
diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.md
index 60d13f6..88bc66f 100644
--- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.md
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.md
@@ -6,7 +6,15 @@ description: Open ACE 文档入口，覆盖部署、架构、Remote Agent 与治
 
 # Open ACE 文档
 
-Open ACE 是一个自托管 AI Coding Agent 工作台与治理控制面。这个站点把仓库中的 Markdown 文档整理成面向部署者、开发者与平台团队的结构化入口。
+Open ACE 是一个面向 AI Coding Agent 的自托管控制面。它把浏览器化 AI 编码会话、Remote Agent 远程执行、GitHub issue 自主开发工作流，以及团队需要的审计与治理能力放在同一个平台里。
+
+## 最近变化
+
+- 自主开发工作流已经可以围绕 GitHub issue 完成计划、实现、评审与最终代码变更总结。
+- 批量 issue、自动合并、暂停/取消、从某个阶段重新 fork 等能力，让 agent 执行更容易运营。
+- 时间线视图增加了里程碑摘要、完整输出、状态语义、用量统计与最终变更展示。
+- Remote Agent 已覆盖 Claude Code、Qwen Code、Codex、OpenClaw 与 ZCode，并加入 token 注册与管理能力。
+- Docker、Package、macOS、源码安装、数据库迁移与升级路径正在持续加固。
 
 ## 建议先阅读
 
@@ -22,6 +30,13 @@ Open ACE 是一个自托管 AI Coding Agent 工作台与治理控制面。这个
 - 负责远程机器、API Key 路由与审计治理的平台团队
 - 需要评估成本、合规与权限边界的管理员
 
+## 项目状态
+
+- [项目概览](/project)
+- [路线图](/project/roadmap)
+- [近期发布与 PR 亮点](/project/releases)
+- [社区入口](/project/community)
+
 ## 文档来源
 
 仓库里的 `docs/en` 与 `docs/cn` 仍然是原始文档来源。站点构建时会自动把这两套文档同步到 Docusaurus。
diff --git a/src/components/project/project.module.css b/src/components/project/project.module.css
index ed5f9fa..0754feb 100644
--- a/src/components/project/project.module.css
+++ b/src/components/project/project.module.css
@@ -210,6 +210,14 @@
   color: #18262b;
 }
 
+.sectionCard p,
+.releaseCard p,
+.communityCard p {
+  margin: 0;
+  color: #4f5d65;
+  line-height: 1.7;
+}
+
 .bulletList,
 .linkList,
 .metaList {
diff --git a/src/data/generated/project-data.json b/src/data/generated/project-data.json
index fa51e77..59c0175 100644
--- a/src/data/generated/project-data.json
+++ b/src/data/generated/project-data.json
@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-06-16T11:09:00.037Z",
+  "generatedAt": "2026-06-17T10:21:24.310Z",
   "repository": {
     "owner": "open-ace",
     "repo": "open-ace",
@@ -14,10 +14,10 @@
     "contributingUrl": "https://github.com/open-ace/open-ace/blob/main/CONTRIBUTING.md",
     "codeOfConductUrl": "https://github.com/open-ace/open-ace/blob/main/CODE_OF_CONDUCT.md",
     "securityUrl": "https://github.com/open-ace/open-ace/security/policy",
-    "stars": null,
-    "forks": null,
-    "openIssues": null,
-    "watchers": null,
+    "stars": 4,
+    "forks": 2,
+    "openIssues": 95,
+    "watchers": 0,
     "defaultBranch": "main",
     "license": "Apache-2.0"
   },
@@ -67,10 +67,10 @@
   },
   "releases": {
     "latest": {
-      "tagName": "1.0.0",
-      "name": "1.0.0",
-      "publishedAt": "2026-06-02",
-      "url": "https://github.com/open-ace/open-ace/releases"
+      "tagName": "v1.0.0",
+      "name": "Open ACE v1.0.0",
+      "publishedAt": "2026-06-02T11:06:01Z",
+      "url": "https://github.com/open-ace/open-ace/releases/tag/v1.0.0"
     },
     "entries": [
       {
@@ -119,7 +119,16 @@
         ]
       }
     ],
-    "githubRecent": []
+    "githubRecent": [
+      {
+        "tagName": "v1.0.0",
+        "name": "Open ACE v1.0.0",
+        "publishedAt": "2026-06-02T11:06:01Z",
+        "url": "https://github.com/open-ace/open-ace/releases/tag/v1.0.0",
+        "draft": false,
+        "prerelease": false
+      }
+    ]
   },
   "community": {
     "contributingUrl": "https://github.com/open-ace/open-ace/blob/main/CONTRIBUTING.md",
@@ -128,8 +137,8 @@
     "discussionsUrl": "https://github.com/open-ace/open-ace/discussions",
     "issuesUrl": "https://github.com/open-ace/open-ace/issues",
     "pullsUrl": "https://github.com/open-ace/open-ace/pulls",
-    "goodFirstIssueCount": null,
-    "openPullRequestCount": null,
+    "goodFirstIssueCount": 3,
+    "openPullRequestCount": 6,
     "starterFocus": [
       "First-run setup and deployment fixes",
       "Docs parity between Chinese and English",
diff --git a/src/pages/index.js b/src/pages/index.js
index 201d3dc..8d50ae6 100644
--- a/src/pages/index.js
+++ b/src/pages/index.js
@@ -6,52 +6,75 @@ import styles from './index.module.css';
 
 const featureCards = [
   {
-    title: 'Unified AI coding workspace',
+    title: 'Autonomous development workspace',
     description:
-      'Run Claude Code, Qwen Code, Codex, and OpenClaw behind one self-hosted control plane.',
+      'Turn GitHub issues into planned, executed, reviewed, and merge-ready AI coding workflows.',
   },
   {
-    title: 'Remote Agent execution',
+    title: 'Multi-agent remote execution',
     description:
-      'Push coding sessions onto remote Linux, macOS, and Windows machines without handing out raw SSH access.',
+      'Run Claude Code, Qwen Code, Codex, OpenClaw, and ZCode on controlled remote machines.',
   },
   {
     title: 'Governance and observability',
     description:
-      'Track API key routing, permissions, quotas, cost, audit, and compliance from the same platform.',
+      'Track API key routing, token usage, timeline status, audit events, quotas, and cost signals.',
   },
 ];
 
 const audienceCards = [
   {
     eyebrow: 'For builders',
-    title: 'Give developers one place to work with AI agents',
-    body: 'Open ACE combines multi-tool sessions, remote workspaces, prompt reuse, and browser-based access.',
+    title: 'Run real AI development work from issues',
+    body: 'Batch GitHub issues, inspect milestone timelines, fork from a previous step, and keep final code changes visible.',
   },
   {
     eyebrow: 'For platform teams',
     title: 'Keep deployment and secrets inside your boundary',
-    body: 'Remote Agent and API Key Proxy are designed for self-hosted environments, internal machines, and controlled access.',
+    body: 'Remote Agent, token-based registration, and API Key Proxy keep machines, credentials, and execution policy self-hosted.',
   },
   {
     eyebrow: 'For governance',
-    title: 'See usage, risk, and ROI without stitching tools together',
-    body: 'Manage mode is built around cost visibility, quotas, audit trails, compliance reporting, and policy controls.',
+    title: 'See what happened while the agent worked',
+    body: 'Compact timeline cards, full-text milestone views, session topology, audit logs, and usage counters make runs explainable.',
   },
 ];
 
 const signalItems = [
   {
-    label: 'Work mode',
-    value: 'Sessions, prompts, remote machines, browser workspace',
+    label: 'Latest focus',
+    value: 'Autonomous workflows, batch issues, timeline UX, ZCode support',
   },
   {
-    label: 'Manage mode',
-    value: 'API keys, quotas, audit, compliance, ROI',
+    label: 'Execution layer',
+    value: 'Remote Agent, token auth, CLI adapters, app-server mode',
   },
   {
     label: 'Best next read',
-    value: 'Remote Agent, Deployment, Permission Model',
+    value: 'Remote Agent, Deployment, Permission Model, Project status',
+  },
+];
+
+const recentHighlights = [
+  {
+    title: 'Autonomous workflows became a product surface',
+    description:
+      'Recent PRs added issue-driven autonomous development, batch navigation, auto-merge controls, retry/timeout fixes, and session-aware execution.',
+  },
+  {
+    title: 'Execution is easier to inspect',
+    description:
+      'Timeline cards now show milestone summaries, full-text detail, final code changes, status filters, deep links, and clearer pause/failure semantics.',
+  },
+  {
+    title: 'Remote Agent is broader and safer',
+    description:
+      'ZCode joined Claude Code, Qwen Code, Codex, and OpenClaw, while token management and remote identity checks hardened agent access.',
+  },
+  {
+    title: 'Install and upgrade paths are getting real attention',
+    description:
+      'Docker, package, macOS, sudoers, migration, and config-path fixes make first-run and upgrade flows less brittle for evaluators.',
   },
 ];
 
@@ -66,11 +89,11 @@ export default function Home() {
         <div className={styles.heroInner}>
           <div className={styles.heroCopy}>
             <p className={styles.kicker}>Open ACE</p>
-            <h1>Self-hosted AI coding workspace for real engineering teams.</h1>
+            <h1>Self-hosted control plane for AI coding agents.</h1>
             <p className={styles.heroText}>
-              Open ACE gives teams a browser-based workspace for AI coding agents plus the
-              governance plane needed to run them on internal machines, controlled API keys,
-              and auditable workflows.
+              Open ACE gives teams a browser workspace for AI coding agents, a remote execution
+              layer for internal machines, and an auditable autonomous workflow system that can
+              take GitHub issues from plan to implementation.
             </p>
             <div className={styles.heroActions}>
               <Link className="button button--primary button--lg" to="/docs/intro">
@@ -83,8 +106,8 @@ export default function Home() {
           </div>
           <div className={styles.heroPanel}>
             <div className={styles.heroPanelTop}>
-              <span className={styles.panelBadge}>Phase 1</span>
-              <span className={styles.panelBadgeMuted}>Docs and product site</span>
+              <span className={styles.panelBadge}>Current</span>
+              <span className={styles.panelBadgeMuted}>Updated from recent PRs</span>
             </div>
             {signalItems.map((item) => (
               <div key={item.label} className={styles.signalBlock}>
@@ -100,7 +123,7 @@ export default function Home() {
         <section className={styles.section}>
           <div className={styles.sectionHeader}>
             <p className={styles.kicker}>Core value</p>
-            <h2>Three layers, one platform</h2>
+            <h2>From AI sessions to autonomous engineering runs</h2>
           </div>
           <div className={styles.featureGrid}>
             {featureCards.map((card) => (
@@ -115,7 +138,7 @@ export default function Home() {
         <section className={clsx(styles.section, styles.audienceSection)}>
           <div className={styles.sectionHeader}>
             <p className={styles.kicker}>Why teams adopt it</p>
-            <h2>Designed for self-hosted, multi-agent, governed AI engineering</h2>
+            <h2>Designed for teams that need useful automation and real control</h2>
           </div>
           <div className={styles.audienceGrid}>
             {audienceCards.map((card) => (
@@ -128,10 +151,25 @@ export default function Home() {
           </div>
         </section>
 
+        <section className={styles.section}>
+          <div className={styles.sectionHeader}>
+            <p className={styles.kicker}>Recent momentum</p>
+            <h2>What changed in the last three weeks</h2>
+          </div>
+          <div className={styles.featureGrid}>
+            {recentHighlights.map((card) => (
+              <article key={card.title} className={styles.featureCard}>
+                <h3>{card.title}</h3>
+                <p>{card.description}</p>
+              </article>
+            ))}
+          </div>
+        </section>
+
         <section className={styles.section}>
           <div className={styles.sectionHeader}>
             <p className={styles.kicker}>Start here</p>
-            <h2>Phase 1 site scope</h2>
+            <h2>Evaluate the current product surface</h2>
           </div>
           <div className={styles.linkGrid}>
             <Link className={styles.linkCard} to="/docs/intro">
@@ -152,7 +190,7 @@ export default function Home() {
             </Link>
             <Link className={styles.linkCard} to="/project">
               <span>Project Status</span>
-              <strong>View roadmap, release history, and contribution entry points from the site</strong>
+              <strong>View recent highlights, roadmap, release history, and contribution entry points</strong>
             </Link>
           </div>
         </section>
diff --git a/src/pages/project/index.js b/src/pages/project/index.js
index f51aab5..3883a3f 100644
--- a/src/pages/project/index.js
+++ b/src/pages/project/index.js
@@ -4,6 +4,21 @@ import Translate from '@docusaurus/Translate';
 import {ProjectChrome, formatNumber, projectData, styles} from '../../components/project/ProjectLayout';
 
 export default function ProjectOverviewPage() {
+  const recentProductSignals = [
+    {
+      title: 'Autonomous development is now central',
+      body: 'Open ACE can run issue-driven workflows with planning, execution, review, final code changes, batch issue navigation, and auto-merge controls.',
+    },
+    {
+      title: 'Timeline UX makes agent work inspectable',
+      body: 'Recent timeline updates added compact milestone cards, summaries, full-text views, status semantics, deep links, and clearer failure/pause behavior.',
+    },
+    {
+      title: 'Remote execution is expanding',
+      body: 'ZCode support, app-server mode, token-based remote agent identity, and CLI adapter hardening broaden the execution layer beyond the original tool set.',
+    },
+  ];
+
   const metrics = [
     {
       label: 'Stars',
@@ -24,11 +39,30 @@ export default function ProjectOverviewPage() {
 
   return (
     <ProjectChrome
-      title="Project visibility without leaving the docs site."
-      description="This section turns repository state, roadmap planning, changelog history, and community entry points into a single public surface. The content is generated during the site build, so the docs site stays synchronized with the repository instead of hand-maintained screenshots."
+      title="Project momentum without leaving the docs site."
+      description="Open ACE is moving quickly from a self-hosted AI coding workspace into an autonomous engineering control plane. This section turns repository state, roadmap planning, release history, and contribution entry points into a single public surface."
       eyebrow="Project"
       active="overview"
     >
+      <section className={styles.section}>
+        <div className={styles.sectionHeader}>
+          <h2>Recent product direction</h2>
+          <p>
+            The last three weeks of merged PRs show a clear product shape: autonomous development
+            workflows, observable execution timelines, safer remote agents, and more reliable
+            install/upgrade paths.
+          </p>
+        </div>
+        <div className={styles.cardGrid}>
+          {recentProductSignals.map((signal) => (
+            <article key={signal.title} className={styles.sectionCard}>
+              <h3>{signal.title}</h3>
+              <p>{signal.body}</p>
+            </article>
+          ))}
+        </div>
+      </section>
+
       <section className={styles.section}>
         <div className={styles.sectionHeader}>
           <h2>Live repository signals</h2>
@@ -59,27 +93,27 @@ export default function ProjectOverviewPage() {
         </div>
         <div className={styles.cardGrid}>
           <article className={styles.sectionCard}>
-            <h3>Roadmap page</h3>
+            <h3>Autonomous workflow story</h3>
             <ul className={styles.bulletList}>
-              <li>Structured rendering of roadmap lanes from the repository source file</li>
-              <li>Clear separation between current work, upcoming work, and success criteria</li>
-              <li>Internal links from the landing site instead of raw GitHub Markdown links</li>
+              <li>Issue-driven runs with plan, implementation, review, and final summary stages</li>
+              <li>Batch issue support for operating multiple GitHub issues from one workflow</li>
+              <li>Timeline cards that expose progress, failures, retries, and code changes</li>
             </ul>
           </article>
           <article className={styles.sectionCard}>
-            <h3>Release page</h3>
+            <h3>Remote execution story</h3>
             <ul className={styles.bulletList}>
-              <li>Latest release summary plus changelog sections extracted during build</li>
-              <li>Fallback to committed changelog data when live release API data is unavailable</li>
-              <li>Better signal for evaluators deciding whether the project is actively maintained</li>
+              <li>Remote Agent registration and token management for controlled machines</li>
+              <li>CLI adapters for Claude Code, Qwen Code, Codex, OpenClaw, and ZCode</li>
+              <li>Docker, package, macOS, and source install paths receiving active fixes</li>
             </ul>
           </article>
           <article className={styles.sectionCard}>
-            <h3>Community page</h3>
+            <h3>Project transparency story</h3>
             <ul className={styles.bulletList}>
-              <li>Contribution, security, issues, PRs, and discussions in one place</li>
-              <li>Starter focus areas for new contributors</li>
-              <li>Build-time counters for open PRs and good-first-issue inventory when possible</li>
+              <li>Roadmap, releases, community links, and GitHub signals stay visible from docs</li>
+              <li>Build-time counters show issues, starter work, and repository metadata</li>
+              <li>Docs are split from the application repo so product docs can evolve cleanly</li>
             </ul>
           </article>
         </div>
diff --git a/src/pages/project/releases.js b/src/pages/project/releases.js
index 8d391af..92e7031 100644
--- a/src/pages/project/releases.js
+++ b/src/pages/project/releases.js
@@ -2,6 +2,49 @@ import React from 'react';
 import Link from '@docusaurus/Link';
 import {ProjectChrome, formatDate, projectData, styles} from '../../components/project/ProjectLayout';
 
+const recentHighlights = [
+  {
+    title: 'Autonomous development workflows',
+    links: [
+      ['#717', 'full autonomous development workspace'],
+      ['#925', 'batched GitHub issues'],
+      ['#929', 'batch workflow auto-merge'],
+      ['#984', 'session topology and final summaries'],
+    ],
+  },
+  {
+    title: 'Timeline and run observability',
+    links: [
+      ['#982', 'timeline and batch UX'],
+      ['#995', 'milestone TL;DR summaries'],
+      ['#1056', 'streamlined timeline summaries'],
+      ['#1059', 'compact milestone cards'],
+    ],
+  },
+  {
+    title: 'Remote Agent and CLI coverage',
+    links: [
+      ['#773', 'token-based remote agent auth'],
+      ['#888', 'agent client token management'],
+      ['#890', 'token rotate/revoke UI'],
+      ['#1074', 'ZCode CLI and app-server mode'],
+    ],
+  },
+  {
+    title: 'Deployment and upgrade reliability',
+    links: [
+      ['#901', 'Docker upgrade mode'],
+      ['#1020', 'macOS deployment paths'],
+      ['#1053', 'install upgrade/migration checks'],
+      ['#1079', 'Docker upgrade config detection'],
+    ],
+  },
+];
+
+function prUrl(label) {
+  return `${projectData.repository.pullsUrl}/${label.replace('#', '')}`;
+}
+
 export default function ReleasesPage() {
   const releasedEntries = projectData.releases.entries.filter((entry) => entry.version !== 'Unreleased');
 
@@ -34,6 +77,30 @@ export default function ReleasesPage() {
         </article>
       </section>
 
+      <section className={styles.section}>
+        <div className={styles.sectionHeader}>
+          <h2>Since v1.0.0</h2>
+          <p>
+            The repository has shipped a dense set of post-release PRs. These highlights are curated
+            from the most visible product changes over the last three weeks.
+          </p>
+        </div>
+        <div className={styles.timelineGrid}>
+          {recentHighlights.map((highlight) => (
+            <article key={highlight.title} className={styles.releaseCard}>
+              <h3>{highlight.title}</h3>
+              <ul className={styles.bulletList}>
+                {highlight.links.map(([label, text]) => (
+                  <li key={label}>
+                    <Link to={prUrl(label)}>{label}</Link> {text}
+                  </li>
+                ))}
+              </ul>
+            </article>
+          ))}
+        </div>
+      </section>
+
       <section className={styles.section}>
         <div className={styles.sectionHeader}>
           <h2>Changelog highlights</h2>
diff --git a/src/pages/project/roadmap.js b/src/pages/project/roadmap.js
index f70c80e..f03a350 100644
--- a/src/pages/project/roadmap.js
+++ b/src/pages/project/roadmap.js
@@ -2,13 +2,36 @@ import React from 'react';
 import {ProjectChrome, projectData, styles} from '../../components/project/ProjectLayout';
 
 export default function RoadmapPage() {
+  const activeThemes = [
+    'Make autonomous workflows dependable enough for real repository work, including pause, retry, timeout, review, and merge behavior.',
+    'Improve evaluator confidence with timeline summaries, full-text milestone views, final code changes, and release/project transparency.',
+    'Keep remote execution practical across Docker, package installs, macOS, Windows, source installs, and additional CLI agents such as ZCode.',
+  ];
+
   return (
     <ProjectChrome
-      title="A practical roadmap, not a vague wishlist."
-      description="This view is generated from the repository roadmap file. It keeps the public roadmap inside the docs site while still preserving Git-based review and editing workflows for maintainers."
+      title="A practical roadmap for autonomous AI engineering."
+      description="This view combines the repository roadmap with the recent product direction visible in merged PRs: dependable autonomous workflows, inspectable execution, and safer self-hosted deployment."
       eyebrow="Roadmap"
       active="roadmap"
     >
+      <section className={styles.section}>
+        <div className={styles.sectionHeader}>
+          <h2>Active themes from recent PRs</h2>
+          <p>
+            The public roadmap remains the source of truth, but recent merged work adds useful context
+            for evaluators who want to understand where Open ACE is heading right now.
+          </p>
+        </div>
+        <article className={styles.sectionCard}>
+          <ul className={styles.bulletList}>
+            {activeThemes.map((theme) => (
+              <li key={theme}>{theme}</li>
+            ))}
+          </ul>
+        </article>
+      </section>
+
       <section className={styles.section}>
         <div className={styles.sectionHeader}>
           <h2>Tracked roadmap lanes</h2>