kenaz 0.3.22 → 0.3.24

package/core/dev/MOBILE_DESIGN_SPEC.md

@@ -1,569 +0,0 @@
-# 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

@@ -1,136 +0,0 @@
-# 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 債在頭注已列）。