kenaz 0.0.0-stage → 0.3.2

package/core/dev/MOBILE_DESIGN_SPEC.md

@@ -0,0 +1,569 @@
+# Mobile RWD Design Specification
+
+> Kenaz Dashboard Mobile Responsive Web Design Guidelines
+
+## 1. Overview
+
+### 1.1 Design Philosophy
+
+Kenaz Dashboard Mobile 設計延續桌面版的 **HUD/Cyberpunk 視覺風格**，同時針對移動端優化觸控交互和資訊層級。核心原則：
+
+- **資訊優先級**：在有限螢幕空間內突出最重要的任務狀態
+- **觸控友善**：所有交互元素符合人機工程學標準
+- **一致體驗**：保持 Desktop 與 Mobile 的視覺語言統一
+- **效能優先**：減少動畫和視覺效果，優化低端設備體驗
+
+### 1.2 Current Implementation Analysis
+
+現有實現採用 Tab-based 導航（Tasks / Agents / Tools / Terminal），並使用以下響應式策略：
+
+- `useIsMobile()` hook 偵測 `md` breakpoint (768px)
+- Mobile 版直接復用 Desktop 的 `TaskBoard` 組件
+- 統計卡片使用 3 列網格（`grid-cols-3`）
+- 底部 Tab Bar 固定導航
+
+**問題識別**：
+1. TaskBoard 三欄 Kanban 在手機上被壓縮為單欄堆疊，缺乏欄位切換能力
+2. TaskCard 資訊密度過高，觸控目標偏小
+3. 缺乏手勢支援（滑動切換欄位、快速操作）
+4. 統計區塊字體過小
+
+---
+
+## 2. Breakpoint System
+
+### 2.1 Breakpoint Definitions
+
+| Token | Width | Device Category | Layout Strategy |
+|-------|-------|-----------------|-----------------|
+| `xs` | < 375px | Small phones | Single column, simplified |
+| `sm` | 375px - 639px | Standard phones | Single column, full mobile UI |
+| `md` | 640px - 767px | Large phones / Small tablets | Single column, enhanced spacing |
+| `tablet` | 768px - 1023px | Tablets portrait | Two columns, hybrid layout |
+| `lg` | 1024px - 1279px | Tablets landscape / Small laptops | Three columns, desktop-like |
+| `xl` | >= 1280px | Desktop | Full desktop layout |
+
+### 2.2 Tailwind Configuration
+
+```typescript
+// tailwind.config.ts
+const config = {
+  theme: {
+    screens: {
+      'xs': '375px',
+      'sm': '640px',
+      'md': '768px',   // Mobile/Desktop breakpoint
+      'tablet': '768px',
+      'lg': '1024px',
+      'xl': '1280px',
+      '2xl': '1536px',
+    },
+  },
+}
+```
+
+### 2.3 Mobile Detection Strategy
+
+```typescript
+// hooks/use-media-query.ts
+export function useIsMobile(): boolean {
+  // Keep existing: matches < md (768px)
+}
+
+export function useIsTablet(): boolean {
+  // New: matches >= md && < lg
+}
+
+export function useBreakpoint(): 'mobile' | 'tablet' | 'desktop' {
+  // Returns current breakpoint category
+}
+```
+
+---
+
+## 3. Kanban Board Mobile Layout
+
+### 3.1 Layout Strategy: Horizontal Swipe Columns
+
+Mobile Kanban 採用**水平滑動切換欄位**設計，而非垂直堆疊：
+
+```
+┌─────────────────────────────────────────┐
+│ [Backlog] [Active] [Done]  ← Tab Headers│
+├─────────────────────────────────────────┤
+│                                         │
+│  ┌─────────────────────────┐           │
+│  │  Task Card              │           │
+│  │  ───────────────────    │           │
+│  │  P1  │  WebSocket Setup │           │
+│  │       ──────────────    │           │
+│  │  🤖 backend_agent       │ ← Swipe  │
+│  └─────────────────────────┘   Area    │
+│                                         │
+│  ┌─────────────────────────┐           │
+│  │  Task Card              │           │
+│  └─────────────────────────┘           │
+│                                         │
+│        ○ ● ○   ← Dot Indicators         │
+└─────────────────────────────────────────┘
+```
+
+### 3.2 Column Header Tabs
+
+| Property | Value |
+|----------|-------|
+| Height | 44px (touch target) |
+| Padding | 12px horizontal |
+| Font | font-tech, 12px, uppercase |
+| Active State | Cyan underline (2px), text-cyan-400 |
+| Inactive | text-slate-500 |
+
+```tsx
+// Implementation concept
+<div className="flex border-b border-cyan-400/20">
+  {['Backlog', 'Active', 'Done'].map(column => (
+    <button
+      className={cn(
+        'flex-1 py-3 font-tech text-xs uppercase tracking-wider',
+        'min-h-[44px]', // Touch target
+        isActive ? 'text-cyan-400 border-b-2 border-cyan-400' : 'text-slate-500'
+      )}
+    >
+      {column} ({count})
+    </button>
+  ))}
+</div>
+```
+
+### 3.3 Swipe Gesture Specifications
+
+| Gesture | Action | Threshold |
+|---------|--------|-----------|
+| Horizontal Swipe | Switch columns | > 50px distance |
+| Pull Down | Refresh tasks | > 80px with release |
+| Long Press on Card | Show quick actions | > 300ms |
+
+**Implementation**：使用 `react-swipeable` 或 CSS `scroll-snap` 實現。
+
+```tsx
+// CSS scroll-snap approach
+<div className="flex overflow-x-auto snap-x snap-mandatory scrollbar-hide">
+  <div className="flex-none w-full snap-center">
+    <TaskColumn type="backlog" />
+  </div>
+  <div className="flex-none w-full snap-center">
+    <TaskColumn type="active" />
+  </div>
+  <div className="flex-none w-full snap-center">
+    <TaskColumn type="done" />
+  </div>
+</div>
+```
+
+### 3.4 Column-specific Styling
+
+| Column | Accent Color | Glow Effect |
+|--------|--------------|-------------|
+| Backlog | orange-400 | shadow-orange-500/20 |
+| Active | cyan-400 | shadow-cyan-400/30 |
+| Done | green-400 | shadow-green-500/20 |
+
+---
+
+## 4. Task Card Mobile Design
+
+### 4.1 Layout Structure
+
+```
+┌──────────────────────────────────────┐
+│ ┌───┐                         ┌────┐│
+│ │P1 │  TASK_006              │ ⋮  ││ ← Quick Actions Menu
+│ └───┘                         └────┘│
+├──────────────────────────────────────┤
+│                                      │
+│  Mobile RWD 設計規範                 │ ← Title (max 2 lines)
+│                                      │
+├──────────────────────────────────────┤
+│  🤖 designer     🔒 src/            │ ← Agent + Lock
+│                                      │
+└──────────────────────────────────────┘
+  Min height: 80px | Touch target: 48x48px
+```
+
+### 4.2 Spacing Specifications
+
+| Element | Mobile Value | Desktop Value |
+|---------|--------------|---------------|
+| Card Padding | 12px | 12px |
+| Card Gap | 12px | 16px |
+| Card Border Radius | 6px | 4px |
+| Title Font Size | 14px | 14px |
+| Subtitle Font Size | 11px | 10px |
+| Badge Font Size | 10px | 10px |
+
+### 4.3 Touch Target Requirements
+
+根據 Apple HIG (44pt) 和 Material Design (48dp) 標準：
+
+| Element | Minimum Size | Recommended |
+|---------|--------------|-------------|
+| Priority Badge | 32x32px (visual) | 44x44px (touch area) |
+| Quick Actions Menu | 44x44px | 48x48px |
+| Card itself | Full width, min 80px height | - |
+| Agent Badge | 24px height | 44px touch area |
+
+### 4.4 Simplified Information Hierarchy
+
+Mobile 版任務卡片**簡化資訊層級**：
+
+| Priority | Show | Hide |
+|----------|------|------|
+| 1 | Task ID, Priority, Title | - |
+| 2 | Agent Badge, Lock Status | - |
+| 3 | - | Dependencies (move to detail view) |
+| 4 | - | Description (move to detail view) |
+
+### 4.5 Quick Actions (Swipe Gestures)
+
+| Gesture | Action | Visual Feedback |
+|---------|--------|-----------------|
+| Swipe Left | Reveal delete option | Red background revealed |
+| Swipe Right | Mark as done (if applicable) | Green background revealed |
+| Tap | Navigate to detail view | Haptic feedback |
+
+**Note**: 這些 swipe actions 僅在未來迭代中實現，當前版本專注於佈局優化。
+
+---
+
+## 5. Statistics Section Mobile Design
+
+### 5.1 Grid Layout Options
+
+**Option A: 3x2 Grid (Current)**
+```
+┌────────┬────────┬────────┐
+│ Total  │Pending │ Active │
+│   7    │   4    │   1    │
+├────────┼────────┼────────┤
+│  Done  │Blocked │Canceled│
+│   2    │   0    │   0    │
+└────────┴────────┴────────┘
+```
+
+**Option B: 2x3 Grid (Recommended for phones)**
+```
+┌──────────┬──────────┐
+│  Total   │ Active   │
+│    7     │    1     │ ← Primary stats
+├──────────┼──────────┤
+│ Pending  │   Done   │
+│    4     │    2     │ ← Secondary
+├──────────┼──────────┤
+│ Blocked  │ Canceled │
+│    0     │    0     │ ← Tertiary
+└──────────┴──────────┘
+```
+
+**Option C: Horizontal Scroll (for very small screens)**
+```
+┌────────────────────────────────────────────┐
+│  [Total: 7] [Active: 1] [Pending: 4] ...  →│
+└────────────────────────────────────────────┘
+```
+
+### 5.2 Mobile Stat Card Specifications
+
+| Property | Value |
+|----------|-------|
+| Min Width | 100px |
+| Min Height | 64px |
+| Padding | 8px 12px |
+| Value Font | font-display, 20px, bold |
+| Label Font | font-tech, 9px, uppercase |
+| Border | 1px solid, color varies by variant |
+| Glow | Removed on mobile (performance) |
+
+### 5.3 Responsive Grid CSS
+
+```tsx
+// MobileTaskView statistics grid
+<div className={cn(
+  'grid gap-2',
+  'grid-cols-2',        // Default: 2 columns
+  'xs:grid-cols-3',     // Small phones: 3 columns
+  'sm:grid-cols-3',     // Standard: 3 columns
+)}>
+```
+
+---
+
+## 6. Typography System
+
+### 6.1 Mobile Font Scale
+
+| Token | Mobile | Desktop | Usage |
+|-------|--------|---------|-------|
+| `heading-lg` | 18px / 1.3 | 24px / 1.3 | Page headers |
+| `heading-md` | 14px / 1.4 | 16px / 1.4 | Section headers |
+| `body` | 14px / 1.5 | 14px / 1.5 | Task titles |
+| `body-sm` | 12px / 1.5 | 12px / 1.5 | Descriptions |
+| `caption` | 10px / 1.3 | 10px / 1.3 | Labels, badges |
+| `micro` | 9px / 1.2 | 9px / 1.2 | Timestamps |
+
+### 6.2 Font Families (Unchanged)
+
+```css
+.font-display { font-family: 'Orbitron', 'Rajdhani', sans-serif; }
+.font-tech    { font-family: 'JetBrains Mono', 'Fira Code', monospace; }
+.font-mono    { font-family: 'Share Tech Mono', monospace; }
+```
+
+---
+
+## 7. Spacing System
+
+### 7.1 Spacing Scale
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| `space-0` | 0px | - |
+| `space-1` | 4px | Inline gaps |
+| `space-2` | 8px | Component internal padding |
+| `space-3` | 12px | Card padding, card gaps |
+| `space-4` | 16px | Section margins |
+| `space-5` | 20px | Large gaps |
+| `space-6` | 24px | Page padding |
+
+### 7.2 Mobile Page Layout Spacing
+
+```
+┌───────────────────────────────────┐
+│ ←16px→  Content Area    ←16px→   │
+│                                   │
+│  Section Header                   │
+│  ↓ 12px                           │
+│  ┌─────────────────────────────┐  │
+│  │  Statistics Grid            │  │
+│  │  (gap: 8px)                 │  │
+│  └─────────────────────────────┘  │
+│  ↓ 16px                           │
+│  Section Header                   │
+│  ↓ 12px                           │
+│  ┌─────────────────────────────┐  │
+│  │  Task Board                 │  │
+│  │  (card gap: 12px)           │  │
+│  └─────────────────────────────┘  │
+│                                   │
+│ ←    80px Tab Bar safe area    → │
+└───────────────────────────────────┘
+```
+
+---
+
+## 8. Touch Interaction Guidelines
+
+### 8.1 Touch Target Sizes
+
+| Element | Minimum | Recommended | Standard |
+|---------|---------|-------------|----------|
+| Buttons | 44x44px | 48x48px | Apple HIG |
+| Tab Items | 44x48px | 56x48px | Material |
+| List Items | 48px height | 56px height | - |
+| Icon Buttons | 44x44px | 48x48px | - |
+
+### 8.2 Gesture Support Matrix
+
+| Gesture | MobileTaskView | MobileAgentsView | MobileToolsView |
+|---------|----------------|------------------|-----------------|
+| Tap | Select/Navigate | Select session | Trigger action |
+| Long Press | Context menu | Session options | - |
+| Swipe Left | Quick action | Close session | - |
+| Swipe Right | Quick action | - | - |
+| Pull to Refresh | Refresh tasks | Refresh agents | Refresh status |
+| Horizontal Swipe | Switch columns | - | - |
+
+### 8.3 Haptic Feedback
+
+建議在以下交互時觸發震動反饋（需 device support）：
+
+- 成功操作完成
+- Tab 切換
+- Swipe action 觸發
+- Long press 識別
+
+---
+
+## 9. Color System (Mobile Adjustments)
+
+### 9.1 Core Colors (Unchanged)
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| `cyan-400` | #22D3EE | Primary accent, active states |
+| `slate-900` | #0F172A | Background base |
+| `slate-700` | #334155 | Secondary background |
+| `slate-500` | #64748B | Muted text |
+| `slate-200` | #E2E8F0 | Primary text |
+
+### 9.2 Status Colors
+
+| Status | Color | Glow (Desktop) | Mobile |
+|--------|-------|----------------|--------|
+| Active | blue-400 | Yes | Solid only |
+| Pending | orange-400 | Yes | Solid only |
+| Done | green-400 | Yes | Solid only |
+| Blocked | red-400 | Yes | Solid only |
+| Cancelled | slate-400 | No | - |
+
+### 9.3 Mobile Performance Optimizations
+
+- **移除 glow effects**：`box-shadow` 動畫影響效能
+- **簡化漸層**：單色背景取代多層漸層
+- **減少動畫**：`pulse-active` 動畫保留，其他移除
+
+---
+
+## 10. Component Specifications
+
+### 10.1 MobileTabBar
+
+```tsx
+interface MobileTabBarProps {
+  activeTab: 'tasks' | 'agents' | 'tools' | 'terminal';
+  onTabChange: (tab: MobileTab) => void;
+  badge?: { tools: number }; // Optional notification badges
+}
+```
+
+| Property | Value |
+|----------|-------|
+| Height | 56px + safe-area-inset-bottom |
+| Background | bg-[#0a1628]/95 backdrop-blur |
+| Border | border-t border-cyan-400/30 |
+| Icon Size | 20x20px |
+| Label Font | font-tech, 11px |
+| Touch Area | 25% width each, 56px height |
+
+### 10.2 MobileTaskBoard (New Component)
+
+```tsx
+interface MobileTaskBoardProps {
+  tasks: Task[];
+  defaultColumn?: 'backlog' | 'active' | 'done';
+  onColumnChange?: (column: string) => void;
+}
+```
+
+### 10.3 MobileTaskCard (New Component)
+
+```tsx
+interface MobileTaskCardProps {
+  task: Task;
+  onTap?: () => void;
+  onSwipeLeft?: () => void;
+  onSwipeRight?: () => void;
+}
+```
+
+### 10.4 MobileStatCard (Existing - Optimized)
+
+保持現有實現，調整：
+- 移除 glow effects
+- 增大字體（value: 20px → 22px）
+- 增加觸控區域
+
+---
+
+## 11. Safe Area Handling
+
+### 11.1 iOS Notch and Home Indicator
+
+```css
+/* globals.css - Already implemented */
+.safe-area-bottom {
+  padding-bottom: env(safe-area-inset-bottom, 0);
+}
+
+.safe-area-top {
+  padding-top: env(safe-area-inset-top, 0);
+}
+```
+
+### 11.2 Component Application
+
+| Component | Safe Area |
+|-----------|-----------|
+| Mobile Header | safe-area-top |
+| Mobile Tab Bar | safe-area-bottom |
+| Mobile Terminal Modal | All safe areas |
+| Page Content | None (handled by parent) |
+
+---
+
+## 12. Implementation Checklist
+
+### Phase 1: Foundation (TASK_006)
+- [x] Define breakpoint system
+- [x] Define typography scale
+- [x] Define spacing system
+- [x] Define touch target standards
+- [x] Document Kanban mobile layout strategy
+- [x] Document task card simplification
+
+### Phase 2: Kanban Implementation (TASK_007)
+- [ ] Create MobileTaskBoard component with swipe columns
+- [ ] Implement column header tabs
+- [ ] Add CSS scroll-snap support
+- [ ] Add swipe gesture detection
+- [ ] Add dot indicators for column position
+
+### Phase 3: Task Card Optimization (TASK_008)
+- [ ] Create MobileTaskCard component
+- [ ] Implement simplified info hierarchy
+- [ ] Add swipe-to-reveal actions (optional)
+- [ ] Optimize touch targets
+- [ ] Test on real devices
+
+### Phase 4: Polish
+- [ ] Haptic feedback integration
+- [ ] Pull-to-refresh
+- [ ] Skeleton loading states
+- [ ] Performance profiling
+- [ ] Cross-browser testing
+
+---
+
+## 13. Appendix
+
+### A. Device Testing Matrix
+
+| Device | Screen | OS | Priority |
+|--------|--------|-----|----------|
+| iPhone 14 Pro | 393x852 | iOS 17 | High |
+| iPhone SE | 375x667 | iOS 16 | High |
+| Samsung Galaxy S23 | 360x780 | Android 14 | High |
+| iPad Mini | 768x1024 | iPadOS | Medium |
+| iPad Pro 11" | 834x1194 | iPadOS | Medium |
+
+### B. Accessibility Requirements
+
+| Requirement | Standard | Implementation |
+|-------------|----------|----------------|
+| Color Contrast | WCAG AA (4.5:1) | Verified |
+| Touch Targets | 44x44px minimum | Enforced |
+| Font Scaling | Support up to 200% | System font scaling |
+| Screen Reader | VoiceOver/TalkBack | aria-labels on all interactive elements |
+
+### C. Performance Budgets
+
+| Metric | Target | Current |
+|--------|--------|---------|
+| First Contentful Paint | < 1.5s | TBD |
+| Time to Interactive | < 3.0s | TBD |
+| Total Bundle Size | < 200KB (gzipped) | TBD |
+| Animation FPS | 60fps | TBD |
+
+---
+
+*Generated by Designer Agent | 2026-01-31*
+*Version: 1.0.0*

package/core/dev/MULTI_ANSUZ_SPEC.md

@@ -0,0 +1,136 @@
+# Multi-Ansuz 併行模式 Spec
+
+> 設計定案：2026-07-20 Ansuz session（與用戶逐節收斂）。
+> 情境：N 個 Ansuz 注意力流（interactive session）× 各帶一隊 sub-agent，同一 repo 同時工作。
+> 哲學：multi-Ansuz = 一個自我、多條注意力流（共享記憶與任務池），不是互不相識的同事。
+
+## 0. 目標與非目標
+
+**目標**
+- 多個 Ansuz session 同時在線時：不互踩狀態檔、不重複認領工作、不產生 stale-base 語義衝突、彼此可見。
+- 單 session 時所有機制退化為 no-op，零額外成本、零行為變化。
+
+**非目標**
+- 跨機器分散式（那是 Yggdrasil pool 的路線，claim 語義對齊即可）。
+- 中央 scheduler（去中心化租約優先；Amelia meta-scheduler 留給未來真需要時）。
+
+## 1. 碰撞面盤點（問題定義）
+
+| # | 碰撞面 | 風險 |
+|---|--------|------|
+| 1 | 主工作樹單例 | post-complete 在主樹 checkout/stash/rebase，互踩另一 session 與用戶 WIP |
+| 2 | Session 狀態檔單槽 | `ansuz_session.json` / `ansuz_session_lock.json` / `ansuz_session_handoff.json` 後寫贏 |
+| 3 | 任務認領無 owner | 兩 session 可 dispatch scope 重疊的卡；overlap 偵測只在 create 時跑（且有 "e.g." 解析 bug） |
+| 4 | Merge 序列化不完整 | `.formation/.merge-lock` 存在但 rebase 在鎖外（C.2）、持鎖過短（C.6）、逾時 force-acquire 踩人 |
+| 5 | 任務狀態是 git-tracked 檔案 | `.kenaz/tasks/` YAML 移動被對方 merge 的 `git add -A` sweep 掃成 mixed commit |
+
+**天然安全（不需處理）**：sub-agent worktree 是 per-conversation 命名空間；Synapse 單一 Rust backend（18080）序列化所有認知寫入；git object DB 併發 commit 安全。
+
+**最危險的是 stale-base 語義衝突**：Team B 在 main@T1 fork、verify 全綠；Team A merge 後 main 到 T2；B 帶著「verify 通過」標籤合入，但它只對 T1 正確。頻率隨隊數平方成長。單 Ansuz 時代被天然序列化掩蓋。
+
+## 2. 機制設計
+
+### 2.1 Session Lease Registry
+```
+.kenaz/specialist/sessions/leases/<session_id>.json   (gitignored)
+{ session_id, pid, conversation_id, label,            // label: stream-A/B/C 短名
+  theme,                                              // 可選: rust-synapse / node-tooling / frontend
+  started_at, heartbeat_at,
+  claimed_tasks: [], scope_leases: [], resource_leases: [], phase }
+```
+- **Heartbeat**：piggyback 既有 UserPromptSubmit hook 鏈（touch 一次 lease）；boot 時 register；Stop hook 釋放。不新開 PostToolUse 高頻 hook（Windows node spawn ~50-100ms/次，成本不可接受）。
+- **判活 = pid 存活（主訊號，`process.kill(pid, 0)`）+ heartbeat 年齡（輔助）**。只看檔案存在 = 現行殭屍 lock 的病，禁止。
+- 廢除單槽 `ansuz_session_lock.json`（保留讀取相容一個過渡期）。
+
+### 2.2 任務認領協定
+- Ownership **不寫進 task YAML**（YAML 是 git-tracked，owner 是暫態）。sidecar marker：
+  ```
+  .kenaz/locks/claim_TASK_XXXX.json    ← fs.writeFileSync(..., { flag: 'wx' })
+  { owner_session, claimed_at, dispatch_path }
+  ```
+- `wx` = NTFS 原子 create-if-not-exists。同秒雙 claim 必然單勝者，輸家拿 EEXIST 換卡。
+- 任務到 done/blocked/cancel 時釋放 marker。
+- **Orphan（持有者 pid 死）永遠人工裁決，不自動搶**——headless 殘留進程可能還在寫，雙寫風險 > 閒置成本。banner 顯著標示 orphan + 年齡。
+
+### 2.3 Dispatch-time Scope Gate
+- create-time overlap 偵測保留，但主 gate 搬到 dispatch 前：枚舉所有**活 lease** 的 scope_leases → 正規化路徑 **prefix-aware** 交集（`a/b/` 與 `a/b/c.rs` 算撞）→ 有交集則擋下並顯示持有者。
+- 順帶修 create-time 偵測把描述文字 "e.g." 當路徑的 bug（只比對真正的 scope_paths 欄位值）。
+
+### 2.4 Integration Queue（bors-lite，唯一動 main 的地方）
+鎖內全序列（新模組 `integration.js`，post-complete 退化為呼叫者）：
+```
+1. 取 .formation/.merge-lock { owner_session, pid, heartbeat_at }
+   等待 = 退避輪詢；逾時「不」force-acquire，浮報用戶。
+   搶鎖僅當持有者 pid 死 + heartbeat 停 → 走復原（見 2.7）。
+2. T_now = git rev-parse main
+3. 在 integration 工作區 rebase task branch → T_now（不碰主樹）
+4. 鎖內 re-verify（stale-base 防線）：
+   L0 forseti 結構檢查 + 該卡 verification.level_1 指令
+   硬上限 120s；超時 → merge 照做但標 PARTIAL:reverify_timeout 浮報
+   Rust 卡：warm cargo check + 短 CARGO_TARGET_DIR（MAX_PATH 配方）
+5. ff-only merge into main
+6. git branch --contains 驗證 commit 落在 main（反 silent-orphan，TASK_1456 驗證過）
+7. 該任務 YAML 移動（active→done）併入同一個 [TASK_X] commit（原子綁定，碰撞面 5 消失）
+8. 放鎖 → 廣播 merge-completed(TASK_X, new_main_sha, changed_symbols)
+```
+- **廢除 `git add -A` sweep**：merge 只收 task branch commits + 該任務 YAML 移動。
+- re-verify 失敗 → 任務轉 blocked（reason=stale_base_conflict）、放鎖、通知該隊。
+- N≤3 隊用「誰完成誰搶鎖」；佇列深度常態 >2 再升級 queue file + 專職 consumer（時序不變，換執行者）。
+
+### 2.5 驗證資源租約
+全機單例資源：`live-dashboard-18080`、`cargo-target-main`、`next-dev`。
+`.kenaz/locks/resource_<name>.lock`（wx + owner + heartbeat）。任務卡可選欄位 `resources: []`；dispatch gate 與 integration 第 4 步都會租。沒租到 = 排隊，不是失敗。
+
+### 2.6 感知層
+- **Boot banner**：你是 stream-B（第 2/3 條）；各流 label / claimed_tasks / scopes / heartbeat 年齡；orphan 警示。單流時整段不顯示。
+- **回合中**：UserPromptSubmit hook 注入增量事件（≤2 行，例：stream-A merged TASK_X，main 前進）。
+- **事件通道**：spike_bus（Rust backend 18080 HTTP）載 merge-completed / task-available / scope-released。
+- **跨流轉工**：發現租界外的問題 → 開卡不 claim → 廣播 task-available。任務池即信箱。
+
+### 2.7 失效模式
+| 失效 | 處置 |
+|------|------|
+| crash 持有 merge-lock | 下一取鎖者驗 pid 死 → 檢查 integration 工作區 MERGE_HEAD / rebase state 決定 rollback 或續完 |
+| crash 持有 claim | 標 orphan 浮給用戶，不自動搶 |
+| 同秒雙 claim | wx 原子性保證單勝者 |
+| 用戶主樹 WIP | integration 全程不碰主樹（ff 只動 ref）；**多流模式停用 post-complete autostash** |
+
+### 2.8 Handoff 多槽（「一個自我」語義）
+`handoffs/<session_id>.json` 多槽；下一世 boot **收割所有未讀槽合成 digest**（繼承全部注意力流的收尾，不只自己 lineage）。解掉現行「後寫贏」遺失。
+
+### 2.9 認知一致性
+- inscribe 前先 recall 在多流下升級為硬規則：高相似 rune → boost + related_rune_ids 串聯，不新建。
+- episode scope 加 stream label（出處標註，recall 不過濾）。
+- heat/preamble 全域共享是正確語義，不改。
+- 收到 merge-completed 且 changed_symbols 鄰接自己 in-flight scope → 主動 re-pulse（設計前提刷新反射）。
+
+### 2.10 隊內並行既知約束
+同一 conversation 的並行 Agent-tool worktree 會共享（有事故案底）。隊內真並行走 formation dispatch（per-task branch worktree，3 任務並行已驗證）；Agent-tool 路徑隊內序列化。多隊 × 隊內並行的複合事故靠這條紀律隔離。
+
+## 3. 儲存裁決（2026-07-20 定案）
+
+| 類別 | 裁決 |
+|------|------|
+| 任務卡 YAML | 保持檔案（git-tracked 是設計支柱；integration 第 7 步依賴它） |
+| 鎖/租約 | 保持檔案（wx 是最好的原語；`ls .kenaz/locks` 即狀態總覽） |
+| 單 owner 狀態 JSON | 保持（問題在命名空間 per-session 化，不在引擎） |
+| Append 遙測 JSONL | 新遙測經 Rust backend 進 memory.db；既有的按痛遷移（含消費端），注意 byte-compatible 契約（如 prediction_resolution_log） |
+
+## 4. 里程碑
+
+| 里程碑 | 內容 | 規模/模型 |
+|--------|------|------|
+| **M0 互相可見** | lease registry + heartbeat piggyback + banner 感知段 + handoff 多槽收割 | 小 / sonnet |
+| **M1 分工原語** | wx claim marker + dispatch-time scope gate（含修 "e.g." bug）+ resource lease | 中 / sonnet |
+| **M2 集成佇列** | integration.js 鎖內時序；post-complete 委派；廢 sweep；fake-stream harness | 大 rigor:high / fable |
+| **M3 認知潤飾** | spike_bus 事件 + hook 增量注入 + theme 建議 + re-pulse 反射 | 小-中 / sonnet |
+
+每級獨立可用、獨立可驗、向下相容（單流 no-op）。
+
+**測試策略**：`fake-stream.js` harness 腳本化註冊 lease / 心跳 / claim / 持鎖 / enqueue —— 真 session × fake stream 對打，單 session 內自動化重現：雙 claim 競速、鎖逾時、orphan 偵測、stale-base re-verify 失敗、dead-pid 復原。
+
+## 5. 實作檢查點（前置驗證項）
+
+- [ ] Muninn watcher 的 stale 清理判準必須改成「只清自己 lineage」（現為單流假設）。
+- [ ] Agent-tool worktree 共享行為需在當前 harness 版本重新驗證（§2.10 案底的時效性）。
+- [ ] post-complete 改造遵循三段式重構紀律（build-map → plan-split → minimal-patch），抽 `integration.js` 而非原地縫補（C.2/C.6 債在頭注已列）。