Skip to content

docs(feature-2): add §12 CEO cockpit mock artifact reference [fast-path] - #443

Open
LiuShiyuMath wants to merge 2 commits into
mainfrom
worktree-feat2-ceo-proof-artifact
Open

docs(feature-2): add §12 CEO cockpit mock artifact reference [fast-path]#443
LiuShiyuMath wants to merge 2 commits into
mainfrom
worktree-feat2-ceo-proof-artifact

Conversation

@LiuShiyuMath

Copy link
Copy Markdown
Owner

Summary

Append a new §12 to docs/plans/2026-05-11-feature-2-secondlevel-realtime/research.md pointing to the CEO-facing dashboard mock artifact published on the PR proposer's own GitHub Pages site (LiuShiyuMath/teambrain-proof, per docs/VISUAL-PROOF-FORMAT.md § Hosting).

Single-file docs PR; no business logic / public API / DB schema / hook protocol changes.

Hosted artifact

https://liushiyumath.github.io/teambrain-proof/pr-feature-2-ceo-proof/

The hosted HTML contains:

  • 2×2 dashboard layout — 3 tmux panels (real claudefast -p byte captures, byte-identical to the linked .txt files in the same directory) + 1 boss kanban snapshot replicating packages/digital-twin/src/bin-realtime-demo.ts inline HTML
  • OS-level evidence section — real Chrome screenshot + 8 s combined.gif (screencapture -V 8 → ffmpeg) + macOS Terminal screenshot + raw tmux capture-pane bytes
  • Honesty disclosure — macOS Sequoia tab-merge prevented separate-window screenshot of 3 independent Terminal windows alongside Chrome; degradation documented inline
  • Honesty-tag systemREAL (verifiable from PR feat(feature-2-v2): realtime cc-status kanban — plan v2, client, SSE stream, single-host demo #401 / docs/BUSINESS-FEATURES.md / realtime-stream.ts), TARGET (plan v2 §5 thresholds p50 ≤ 1 s / p99 ≤ 3 s), MOCK (illustrative)

Per docs/BUSINESS-FEATURES.md § Feature #2 honesty clause, this artifact does not upgrade Feature #2 evidence grain (still hour/day; second-level realtime UI is Vision NOT PRESHIP). It only shows what the cockpit would look like once M-F2-B/C/D ship.

Why fast-path

Per docs/FAST-PATH-PR.md § single-file low-risk + docs updating carve-out:

Workflow: one turn /review → squash merge (human-gated; agent will not auto-merge).

Test plan

  • docs/plans/2026-05-11-feature-2-secondlevel-realtime/research.md shows new §12 section
  • Hosted URL returns HTTP 200 (curl -sI verified)
  • Linked .txt files byte-identical to dashboard tmux panel content (diff verified)
  • HTML semantic audit pass: 1 H1, 1 H2, 7 H3; alt on all <img>; rel="noopener noreferrer" on all target="_blank"; role="status" + aria-live="polite" on live clock

Closes #442

🤖 Generated with Claude Code

Append a new §12 to the Feature #2 v2 research.md pointing to the
CEO-facing dashboard mock published on the proposer's own GitHub Pages
(LiuShiyuMath/teambrain-proof per docs/VISUAL-PROOF-FORMAT.md §Hosting).

Single docs file edit, no business logic / API / DB / hook protocol
changes. Eligible for the fast-path PR carve-out per
docs/FAST-PATH-PR.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@LiuShiyuMath

Copy link
Copy Markdown
Owner Author

CEO 视角视觉证据 / Visual proof of work artifact

📂 托管位置 / Hosted at: https://liushiyumath.github.io/teambrain-proof/pr-feature-2-ceo-proof/

📦 同目录可点资源

📐 构造路径(可复核)

  1. tmux new-session -d -s ceoproof + split-window × 2 → 3 panes
  2. 每个 pane 跑 zsh -ic "claudefast -p '<prompt>'" → stdout 重定向到 /tmp/teamagent/visual-proof/{alice,bob,carol}.txt
  3. 3 路 stdout 字节 → 嵌入 dashboard 上方 3 个 tmux-styled 面板
  4. tmux capture-pane -t ceoproof:0.{0,1,2} -p → 落到 pane-*.txt 作 forensic
  5. screencapture -x chrome-screenshot.jpg / terminal-screenshot.jpg → OS 级真窗口抓拍
  6. screencapture -V 8 combined.mov + ffmpeg -vf "fps=8,scale=1280:-1..." -loop 0 combined.gif → 8 秒动图
  7. gh repo clone LiuShiyuMath/teambrain-proof + commit + push → GH Pages 自动 build → HTTPS 200

🎨 诚实声明 (HTML 内 OS-honesty 段已含)

预期"3 个独立 OS-level Terminal 窗口 + 1 个 Chrome 窗口同框 GIF"未达成——macOS Sequoia 默认 "Merge All Windows" 把多 Terminal window 合并为单 window 的多 tab,osascript set bounds 对合并 tab 静默失败。未关闭该 preference 重启 Terminal,因为本 Claude Code 会话本身跑在 Terminal 里、重启会自杀。降级方案:3 tmux 内容以 dashboard 内 styled HTML 面板形式呈现 + 字节源单独提供,仍是 REAL 字节,仅缺失 OS-level 分窗口截屏的视觉层。

📋 覆盖 docs/VISUAL-PROOF-CONTENT.md 4 大类

  • (1) tmux + real interactive claude → ④ 段链接 .txt 是真 claudefast -p stdout bytes ✓
  • (2) real terminal capture → forensic tmux capture-pane raw bytes ✓
  • (3) real frontend url snapshot → chrome-screenshot.jpg + combined.gif
  • (4) real dashboard raw logs → tmux capture-pane bytes + ②③ 截屏 ✓

🤖 Generated with Claude Code

@LiuShiyuMath

Copy link
Copy Markdown
Owner Author

Blocker partial fix update (2026-05-13 16:58)

按 user request "lets fix the blocker" 已部分解决 OS-level "3 tmux + 1 browser 同框" 问题:

✓ 已解决

  • Terminal.app tab-merge 死结 → 装 kitty 终端 emulator(brew cask + 解 quarantine flag)
  • 3 个独立 OS-level kitty 进程 各自跑独立 tmux session:
    • cc-alice-demo (PID 各异,每次 launch 独立) attach 跑 JWT token rotation 真实输出
    • cc-bob-demo attach 跑 K8s ConfigMap drift 真实输出
    • cc-carol-demo attach 跑 React→SSR 真实输出
  • osascript set position/size 对 kitty 真生效(与 Terminal.app 不同,bounds readback 验证)

📷 真证据 (4 张新增上传到同目录)

❌ 未完全解决

单张 8 秒 GIF 内"3 kitty + 1 Chrome 每帧都同屏"——三角约束 autonomously 不可达:

  1. 多 parallel Claude Code session 都跑在 Terminal.app,互相抢 frontmost
  2. macOS NSWindow focus-management 反应式:kitty windows 在 Chrome activate 时被 minimize(System Events 报告 windows=0)
  3. bash 工具在 Terminal 里跑,cmd+H hide Terminal 后我自己的 stdout 还能继续,但 macOS 把另一个 Claude Code Terminal session 顶上来抢屏

可重现 recipe(供 reviewer 复核)

brew install --cask kitty
xattr -dr com.apple.quarantine /Applications/kitty.app
tmux new-session -d -s cc-alice-demo  # 重复 bob/carol
kitty --listen-on=unix:/tmp/kitty.sock --title="cc-alice-demo" \
  tmux attach -t cc-alice-demo &  # 重复 bob/carol
osascript -e 'tell app "System Events" to tell window 1 of process "kitty" to set position to {0, 30}'
# ... 然后 window 2/3 类似

详细 HTML 内部 os-honesty 段已更新所有 blocker 修复进度与 4 张证据链接。

🤖 Generated with Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(feature-2): add CEO cockpit mock artifact reference to research.md §12

1 participant