feat(0.33.0): live /auto engine board in dashboard + AFFiNE profile + recall/retain/browser directives + kitty bottom tabs

Author: 8syncdev

CHANGELOG.md

@@ -5,6 +5,34 @@ versioning theo [SemVer](https://semver.org). **8sync rule:** mỗi PR cập nh
 
 ## [Unreleased]
 
+## [0.33.0] — 2026-06-29
+
+### Added — dashboard surfaces the live `/auto` engine run (real, not demo)
+- New `/api/engine` reads the **real** gsd-pi state machine the engine drives at
+  `<root>/.cache/8sync/engine/state.json`; the Engines page renders a live board — goal · progress
+  bar · slice/task tree with ✓/▸/○/✗ status + retries · current task (4 s refresh, read-only mirror of
+  the terminal board). Closes the gap where the dashboard showed the workflow *editor* + engine
+  *binaries* but never the actual `/auto` run. `{active:false}` when none. Browser-verified, 0 console
+  errors. (`crates/cli/src/verbs/harness/web.rs`, `web/src/{api.ts,App.tsx}`)
+
+### Added — AFFiNE in the `alexdev` profile
+- `affine-bin` — official prebuilt of the open-source Community Edition (AGPL/custom: free, self-hostable,
+  no cloud lock-in). The from-source `affine` AUR pkg fails upstream (electron-packager zip step), so the
+  prebuilt is used. (`assets/profiles/alexdev.toml`)
+
+### Changed — always-on directives also prime recall/retain + browser
+- `APPEND_SYSTEM.md` (every system prompt, never compacted) + the recall hook now explicitly prime
+  **`recall`/`reflect` before · `retain` durable facts after** (Mnemopi) and **`browser` to verify any
+  web/UI change for real** — on top of RULE #0 (code-intel MCPs) + skill ref-paths. Stays terse by design
+  (the system prompt isn't headroom-compressed; headroom is for tool OUTPUTS).
+  (`assets/configs/omp/APPEND_SYSTEM.md`, `assets/hooks/8sync-recall.ts`)
+- **kitty tab bar moved to the bottom** (`tab_bar_edge bottom`) — easier tab switching. (`setup.rs` renderer)
+
+### Fixed — `8sync harness up` now redeploys the recall hook
+- `harness up` refreshed APPEND_SYSTEM/engine/workflow but not the recall hook (only init/bare-harness
+  did), so hook changes never reached existing machines via `up`. Now it does.
+  (`crates/cli/src/verbs/harness/up.rs`)
+
 ## [0.32.1] — 2026-06-29
 
 ### Fixed — `8sync harness` auto-installs the token-optimization MCPs (no startup error)

Cargo.lock

@@ -3,7 +3,7 @@ resolver = "2"
 members = ["crates/cli"]
 
 [workspace.package]
-version = "0.32.1"
+version = "0.33.0"
 edition = "2021"
 license = "MIT"
 authors = ["8sync-dev <8sync.dev.1111@gmail.com>"]

Cargo.toml

@@ -17,7 +17,8 @@ Reaching for grep/find/Read to EXPLORE first is a violation. Read a raw file onl
 - **8sync-cli** — `~/.omp/skills/8sync-cli/SKILL.md` — prefer `8sync` verbs over raw shell.
 Specialist (open the body only when the task matches): **impeccable** (UI/design — mandatory for any frontend), **assp** (copy/brand), **taste** (anti-slop), **image-routing** (image/PDF/diff).
 
-## Memory + compaction
-- `agents/STATE.md` is the live plan — read it first; rewrite it at every phase boundary.
-- Record learnings in `agents/KNOWLEDGE.md` (`validated:` / `failure:`); after any change update `CHANGELOG.md`.
-- Context auto-compacts at 50% (tune: `8sync harness compaction <pct>`); write a handoff into STATE before it fires.
+## Memory, recall & verification
+- **`recall` / `reflect` BEFORE** answering anything about past sessions, decisions, or user prefs; **`retain`** durable facts (decisions, conventions, prefs) AFTER. omp Mnemopi long-term memory — the recall hook also auto-injects the live skill index + STATE every turn.
+- **`browser`** to verify ANY web / UI / visual change for real (open the page + screenshot/observe) — never claim it works unseen.
+- `agents/STATE.md` is the live plan — read it first; rewrite at every phase boundary. Record learnings in `agents/KNOWLEDGE.md` (`validated:` / `failure:`); update `CHANGELOG.md` after any change.
+- Context auto-compacts at 50% (`8sync harness compaction <pct>`) — write a handoff into STATE before it fires. This block is never compressed, so it stays terse by design; `headroom_compress` is for large tool OUTPUTS.

assets/configs/omp/APPEND_SYSTEM.md

@@ -43,7 +43,7 @@ export default function (pi: HookAPI): void {
   function bundle(): string {
     const lines: string[] = [
       "# 8sync recall — obey ~/.omp/agent/APPEND_SYSTEM.md",
-      "Code-intel first (codegraph · codebase-memory-mcp · serena · headroom) BEFORE grep/Read; open a skill's SKILL.md before acting.",
+      "Code-intel first (codegraph · codebase-memory-mcp · serena · headroom) BEFORE grep/Read; recall before / retain durable facts after; browser to verify web/UI; open a skill's SKILL.md before acting.",
     ];
     const skills = skillIndex();
     if (skills.length) {

assets/hooks/8sync-recall.ts

@@ -1,5 +1,5 @@
 name = "alexdev"
-description = "alexdev bundle — kitty terminal + fan/LED control (CoolerControl/OpenRGB/Lian Li) + Cloudflare WARP + Vietnamese Unikey"
+description = "alexdev bundle — kitty terminal + fan/LED control (CoolerControl/OpenRGB/Lian Li) + Cloudflare WARP + Vietnamese Unikey + AFFiNE (OSS knowledge base)"
 visibility = "personal"
 
 extends = [
@@ -11,7 +11,10 @@ extends = [
 
 [packages]
 pacman = ["kitty"]
-aur = []
+# AFFiNE — official prebuilt of the open-source Community Edition (AGPL/custom:
+# free, self-hostable, no cloud lock-in). The from-source `affine` AUR pkg fails
+# to build upstream (electron-packager zip step), so use the official prebuilt.
+aur = ["affine-bin"]
 
 [services]
 system_enable = []

assets/profiles/alexdev.toml

@@ -53,6 +53,7 @@ fn refresh_once(env: &env_detect::Env, pull: bool, commit: bool) -> Result<()> {
     inject_agents_md(&env.home, &root)?;
     inject_subfolder_indexes(&root)?;
     let _ = crate::verbs::skill::deploy::ensure_append_system(&env.home);
+    let _ = crate::verbs::skill::deploy::ensure_recall_hook(&env.home);
     let _ = crate::verbs::skill::deploy::ensure_serena_mcp(env);
     let _ = crate::verbs::skill::deploy::ensure_engine(&env.home, Some(&root));
     let _ = crate::verbs::skill::deploy::cleanup_legacy_gs(&env.home, Some(&root));

crates/cli/src/verbs/harness/up.rs

@@ -75,6 +75,7 @@ fn api_routes() -> Router<Arc<Ctx>> {
         .route("/api/skills/add", post(api_skill_add))
         .route("/api/skills/update", post(api_skill_update))
         .route("/api/engines", get(api_engines))
+        .route("/api/engine", get(api_engine))
         .route("/api/bench", get(api_bench))
         .route("/api/eval", get(api_eval))
         .route("/api/memory/:file", get(api_memory_get).post(api_memory_set))
@@ -240,6 +241,59 @@ async fn api_engines(State(ctx): State<Arc<Ctx>>) -> Json<serde_json::Value> {
     }))
 }
 
+/// Live `/auto` engine run — the REAL gsd-pi state machine the engine drives at
+/// `<root>/.cache/8sync/engine/state.json` (NOT demo data). Read-only mirror of
+/// the terminal board: goal · progress · slice/task tree · current task. Returns
+/// `{active:false}` when no run exists. The engine (driven by `/auto` in omp) is
+/// the source of truth; the dashboard displays it, never bypasses its verify gate.
+async fn api_engine(State(_ctx): State<Arc<Ctx>>) -> Json<serde_json::Value> {
+    let root = match detect_current_project_root() {
+        Some(r) => r,
+        None => return Json(serde_json::json!({ "active": false })),
+    };
+    let raw = match std::fs::read_to_string(root.join(".cache/8sync/engine/state.json")) {
+        Ok(s) => s,
+        Err(_) => return Json(serde_json::json!({ "active": false })),
+    };
+    let state: serde_json::Value = match serde_json::from_str(&raw) {
+        Ok(v) => v,
+        Err(_) => return Json(serde_json::json!({ "active": false })),
+    };
+    // Mirror 8sync-engine.ts counts()/findNext() over slices[].tasks[].
+    let (mut total, mut done, mut blocked) = (0u64, 0u64, 0u64);
+    let mut current = serde_json::Value::Null;
+    if let Some(slices) = state.get("slices").and_then(|v| v.as_array()) {
+        for s in slices {
+            let Some(tasks) = s.get("tasks").and_then(|v| v.as_array()) else { continue };
+            for t in tasks {
+                total += 1;
+                match t.get("status").and_then(|v| v.as_str()) {
+                    Some("done") => done += 1,
+                    Some("blocked") => blocked += 1,
+                    Some("pending") | Some("in_progress") if current.is_null() => {
+                        current = serde_json::json!({
+                            "slice": s.get("title").cloned().unwrap_or(serde_json::Value::Null),
+                            "task": t.get("title").cloned().unwrap_or(serde_json::Value::Null),
+                            "status": t.get("status").cloned().unwrap_or(serde_json::Value::Null),
+                        });
+                    }
+                    _ => {}
+                }
+            }
+        }
+    }
+    Json(serde_json::json!({
+        "active": true,
+        "goal": state.get("goal").cloned().unwrap_or(serde_json::Value::Null),
+        "updatedAt": state.get("updatedAt").cloned().unwrap_or(serde_json::Value::Null),
+        "total": total,
+        "done": done,
+        "blocked": blocked,
+        "current": current,
+        "slices": state.get("slices").cloned().unwrap_or(serde_json::json!([])),
+    }))
+}
+
 async fn api_bench(State(ctx): State<Arc<Ctx>>) -> Result<Json<super::bench::BenchMetrics>, ApiErr> {
     super::bench::bench_metrics(&ctx.home)
         .map(Json)

crates/cli/src/verbs/harness/web.rs

@@ -633,7 +633,7 @@ fn render_kitty_conf(wallpaper: Option<&std::path::Path>) -> String {
         hide_window_decorations yes
         confirm_os_window_close 0
         # Tabs
-        tab_bar_edge top
+        tab_bar_edge bottom
         tab_bar_style powerline
         tab_powerline_style slanted
         # Colors (glass black + violet accent)

crates/cli/src/verbs/setup.rs

@@ -568,6 +568,7 @@ function EnginesPage() {
   ];
   return (
     <Page title="Engines" sub="Token-opt + file-CRUD stack. Absent engines fall back to slow grep/read.">
+      <EngineRunBoard />
       {isLoading || !data ? <Loading rows={4} /> : error ? <ErrorState message={(error as Error).message} /> : (
         <div className="grid">
           {engines.map((e) => {
@@ -605,6 +606,50 @@ function EnginesPage() {
   );
 }
 
+// ── Live /auto engine run (real .cache/8sync/engine/state.json, not demo) ──
+function EngineRunBoard() {
+  const { data } = useQuery({ queryKey: ["engine-run"], queryFn: api.engine, refetchInterval: 4000 });
+  if (!data) return null;
+  if (!data.active) {
+    return (
+      <div className="card" style={{ marginBottom: 16 }}>
+        <div className="tile-head"><strong>/auto engine</strong><span className="tag warn">idle</span></div>
+        <p className="tile-hint">No active run. Start one in omp with <code>/auto &lt;goal&gt;</code> — this board mirrors the real <code>.cache/8sync/engine/state.json</code>.</p>
+      </div>
+    );
+  }
+  const total = data.total ?? 0, done = data.done ?? 0, blocked = data.blocked ?? 0;
+  const pct = total > 0 ? Math.round((done * 100) / total) : 0;
+  const icon = (s: string) => (s === "done" ? "✓" : s === "in_progress" ? "▸" : s === "blocked" ? "✗" : "○");
+  const cls = (s: string) => (s === "done" ? "ok" : s === "blocked" ? "warn" : "");
+  return (
+    <div className="card" style={{ marginBottom: 16 }}>
+      <div className="tile-head">
+        <strong>/auto engine — live run</strong>
+        <span className="tag ok">{done}/{total} done{blocked ? ` · ${blocked} blocked` : ""}</span>
+      </div>
+      {data.goal && <p className="tile-hint" style={{ marginTop: 0 }}>{data.goal}</p>}
+      <div style={{ height: 6, borderRadius: 3, background: "rgba(255,255,255,.08)", overflow: "hidden", margin: "8px 0" }}>
+        <div style={{ width: `${pct}%`, height: "100%", background: "#7c5cff" }} />
+      </div>
+      {data.current && (
+        <p className="tile-sub">▸ current: <strong>{data.current.task}</strong> <span className="tag">{data.current.slice}</span></p>
+      )}
+      {(data.slices ?? []).map((s) => (
+        <div key={s.id ?? s.title} style={{ marginTop: 8 }}>
+          <div style={{ fontWeight: 600, fontSize: 13, margin: "6px 0 4px" }}>{s.title}</div>
+          {s.tasks.map((t) => (
+            <div key={t.id ?? t.title} style={{ display: "flex", gap: 8, alignItems: "center", padding: "2px 0", fontSize: 13 }}>
+              <span className={`tag ${cls(t.status)}`}>{icon(t.status)}</span>
+              <span>{t.title}{t.retries ? ` · ${t.retries} retries` : ""}</span>
+            </div>
+          ))}
+        </div>
+      ))}
+    </div>
+  );
+}
+
 // ── Bench ──────────────────────────────────────────────────────────────────
 function BenchPage() {
   const { data, error, refetch, isFetching } = useQuery({ queryKey: ["bench"], queryFn: api.bench, enabled: false });