kenaz 0.3.3 → 0.3.6

package/core/.claude/skills/ui-ux-pro-max/scripts/search.py

@@ -1,106 +1,106 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
-Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
-       python search.py "<query>" --design-system [-p "Project Name"]
-       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
-
-Domains: style, prompt, color, chart, landing, product, ux, typography
-Stacks: html-tailwind, react, nextjs
-
-Persistence (Master + Overrides pattern):
-  --persist    Save design system to design-system/MASTER.md
-  --page       Also create a page-specific override file in design-system/pages/
-"""
-
-import argparse
-from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
-from design_system import generate_design_system, persist_design_system
-
-
-def format_output(result):
-    """Format results for Claude consumption (token-optimized)"""
-    if "error" in result:
-        return f"Error: {result['error']}"
-
-    output = []
-    if result.get("stack"):
-        output.append(f"## UI Pro Max Stack Guidelines")
-        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
-    else:
-        output.append(f"## UI Pro Max Search Results")
-        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
-    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
-
-    for i, row in enumerate(result['results'], 1):
-        output.append(f"### Result {i}")
-        for key, value in row.items():
-            value_str = str(value)
-            if len(value_str) > 300:
-                value_str = value_str[:300] + "..."
-            output.append(f"- **{key}:** {value_str}")
-        output.append("")
-
-    return "\n".join(output)
-
-
-if __name__ == "__main__":
-    parser = argparse.ArgumentParser(description="UI Pro Max Search")
-    parser.add_argument("query", help="Search query")
-    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
-    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help="Stack-specific search (html-tailwind, react, nextjs)")
-    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
-    parser.add_argument("--json", action="store_true", help="Output as JSON")
-    # Design system generation
-    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
-    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
-    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
-    # Persistence (Master + Overrides pattern)
-    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/MASTER.md (creates hierarchical structure)")
-    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/pages/")
-    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory)")
-
-    args = parser.parse_args()
-
-    # Design system takes priority
-    if args.design_system:
-        result = generate_design_system(
-            args.query, 
-            args.project_name, 
-            args.format,
-            persist=args.persist,
-            page=args.page,
-            output_dir=args.output_dir
-        )
-        print(result)
-        
-        # Print persistence confirmation
-        if args.persist:
-            project_slug = args.project_name.lower().replace(' ', '-') if args.project_name else "default"
-            print("\n" + "=" * 60)
-            print(f"✅ Design system persisted to design-system/{project_slug}/")
-            print(f"   📄 design-system/{project_slug}/MASTER.md (Global Source of Truth)")
-            if args.page:
-                page_filename = args.page.lower().replace(' ', '-')
-                print(f"   📄 design-system/{project_slug}/pages/{page_filename}.md (Page Overrides)")
-            print("")
-            print(f"📖 Usage: When building a page, check design-system/{project_slug}/pages/[page].md first.")
-            print(f"   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
-            print("=" * 60)
-    # Stack search
-    elif args.stack:
-        result = search_stack(args.query, args.stack, args.max_results)
-        if args.json:
-            import json
-            print(json.dumps(result, indent=2, ensure_ascii=False))
-        else:
-            print(format_output(result))
-    # Domain search
-    else:
-        result = search(args.query, args.domain, args.max_results)
-        if args.json:
-            import json
-            print(json.dumps(result, indent=2, ensure_ascii=False))
-        else:
-            print(format_output(result))
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
+Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
+       python search.py "<query>" --design-system [-p "Project Name"]
+       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
+
+Domains: style, prompt, color, chart, landing, product, ux, typography
+Stacks: html-tailwind, react, nextjs
+
+Persistence (Master + Overrides pattern):
+  --persist    Save design system to design-system/MASTER.md
+  --page       Also create a page-specific override file in design-system/pages/
+"""
+
+import argparse
+from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
+from design_system import generate_design_system, persist_design_system
+
+
+def format_output(result):
+    """Format results for Claude consumption (token-optimized)"""
+    if "error" in result:
+        return f"Error: {result['error']}"
+
+    output = []
+    if result.get("stack"):
+        output.append(f"## UI Pro Max Stack Guidelines")
+        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
+    else:
+        output.append(f"## UI Pro Max Search Results")
+        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
+    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
+
+    for i, row in enumerate(result['results'], 1):
+        output.append(f"### Result {i}")
+        for key, value in row.items():
+            value_str = str(value)
+            if len(value_str) > 300:
+                value_str = value_str[:300] + "..."
+            output.append(f"- **{key}:** {value_str}")
+        output.append("")
+
+    return "\n".join(output)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="UI Pro Max Search")
+    parser.add_argument("query", help="Search query")
+    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
+    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help="Stack-specific search (html-tailwind, react, nextjs)")
+    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
+    parser.add_argument("--json", action="store_true", help="Output as JSON")
+    # Design system generation
+    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
+    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
+    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
+    # Persistence (Master + Overrides pattern)
+    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/MASTER.md (creates hierarchical structure)")
+    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/pages/")
+    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory)")
+
+    args = parser.parse_args()
+
+    # Design system takes priority
+    if args.design_system:
+        result = generate_design_system(
+            args.query, 
+            args.project_name, 
+            args.format,
+            persist=args.persist,
+            page=args.page,
+            output_dir=args.output_dir
+        )
+        print(result)
+        
+        # Print persistence confirmation
+        if args.persist:
+            project_slug = args.project_name.lower().replace(' ', '-') if args.project_name else "default"
+            print("\n" + "=" * 60)
+            print(f"✅ Design system persisted to design-system/{project_slug}/")
+            print(f"   📄 design-system/{project_slug}/MASTER.md (Global Source of Truth)")
+            if args.page:
+                page_filename = args.page.lower().replace(' ', '-')
+                print(f"   📄 design-system/{project_slug}/pages/{page_filename}.md (Page Overrides)")
+            print("")
+            print(f"📖 Usage: When building a page, check design-system/{project_slug}/pages/[page].md first.")
+            print(f"   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
+            print("=" * 60)
+    # Stack search
+    elif args.stack:
+        result = search_stack(args.query, args.stack, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))
+    # Domain search
+    else:
+        result = search(args.query, args.domain, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))

package/core/.collaboration/core/task-api.js

@@ -2111,8 +2111,7 @@ class TaskAPI {
     // TASK_2264: decide up front whether post-complete (below) will measure 'after' in-process.
     // TASK_2288 single-winner rule: whenever a post-complete run is expected for this completion,
     // post-complete's own measurement is the ONE 'after' capture (it runs after merge and feeds the
-    // verdict), so moveTask must not also spawn one. Expected = in-process (below) OR the caller
-    // (headless.js / scheduler, signalled by FORMATION_HEADLESS / FORMATION_SCHEDULER) runs it itself.
+    // verdict), so moveTask must not also spawn one. Expected = in-process (below).
     // moveTask's detached capture stays the sole one only when nobody measures: --skip-post-complete.
     const postCompleteRuns = !options.skipPostComplete;
     const result = await this.moveTask(taskId, 'done', updatedTask, { skipHealthAfter: postCompleteRuns });
@@ -2135,8 +2134,6 @@ class TaskAPI {
     }
 
     // 自動執行 post-complete（除非明確跳過）
-    // - FORMATION_SCHEDULER: 由 scheduler 統一管理，避免重複執行
-    // - FORMATION_HEADLESS: 由 headless.js onDone 統一執行，避免並行 agent git 衝突
     if (postCompleteRuns) {
       try {
         const { postComplete } = require('../../.formation/tools/post-complete.js');

package/core/.formation/README.md

@@ -1,16 +1,10 @@
 # Formation System
 
-Agent 部署陣型系統。根據任務規模選擇適當的陣型。
+Subagent 調度。唯一的 live 路徑：`dispatch.js --dispatch-mode=subagent` 印出 JSON（`promptText` + `agentParams`），由 Ansuz 交給 Agent tool（或 `--harness=codex` 的 Codex `spawn_agent`）執行。
 
-## 陣型一覽
+Headless（`claude -p`、`kenaz_dispatch`）、Squad、Legion、Legacy scheduler 已退役；`squad/`、`legion/` 的 YAML 只是歷史定義，`dispatch.js` 遇到會直接報錯結束。
 
-```
-Unit  →  Solo  →  Squad  →  Legion
- 1×1      1×N      N×1      Native Team
-最輕量    最靈活    真並行    最重火力
-```
-
----
+## 陣型
 
 ### Unit
 
@@ -18,138 +12,37 @@ Unit  →  Solo  →  Squad  →  Legion
 
 派出一個 subagent 執行單一任務，完成後回報結果。不切換角色、不協作，純粹的「去做這件事」。
 
-- 機制：`Task` 工具，單次調用
-- 成本：最低
 - 適用：明確的單一任務、Bug 修復、檔案修改、腳本執行
-
----
+- 可用 skill：`do`、`think`、`plan`
 
 ### Solo
 
 **1 agent, N perspectives** — 單人多視角自主切換。
 
-派出一個 subagent，同時裝備多個專業視角。Agent 根據分析過程中的需要，自主決定何時切換到哪個視角。不是輪流發言，是一個人用不同鏡頭看同一件事。
+一個 subagent，同時裝備多個專業視角，由 agent 自主決定何時切換。
 
-- 機制：`dispatch.js --formation=solo`，prompt 中載入所有 `perspectives`
-- 成本：低（單次 subagent 調用）
+- 機制：`dispatch.js --formation=solo`
 - 適用：策略分析、程式碼審查、方案評估、設計決策
 - 可用 skill：`strategy`（策略分析）、`diagnosis`（問題診斷）
 
-```
-範例：Solo + Strategy
-→ [技術專家] 分析架構影響
-→ 發現成本問題 → [產品策略師] 評估 ROI
-→ 發現安全疑慮 → [風險分析師] 識別風險
-→ 綜合判斷，產出結論
-（視角切換由 agent 自主決定，非固定順序）
-```
-
----
-
-### Squad
-
-**N agents, 1 task** — 多 agent 並行協作。
-
-同時派出多個 subagent，各自負責任務的不同部分，並行執行後整合成果。成員之間不能互相通訊（那是 Legion 的事），各自獨立完成後由 lead 整合。
-
-- 機制：`dispatch.js --formation=squad`，並行啟動多個 Claude 進程
-- 成本：中等（隨 agent 數量線性增長）
-- 適用：並行子任務開發、跨模組批量修改、多區域同步掃蕩
-- 可用 skill：`blitz`（通用並行拆分）、`sweep`（同規則多範圍掃蕩）
-
-**核心約束**：
-- 成員之間 **不通訊**，只靠 `shared_context`（啟動前定義的共享約定）協調
-- 每個成員的 `scope_paths` 不得重疊（避免檔案衝突）
-- 如果子任務之間有依賴關係，不適合用 Squad
-
-```
-範例 1：Squad + blitz（並行拆分）
-├── [part_1] → 實作模組 A 的功能
-├── [part_2] → 實作模組 B 的功能
-└── [part_3] → 實作模組 C 的功能
-→ lead 整合驗證，統一提交
-
-範例 2：Squad + sweep（同規則掃蕩）
-├── [zone_1] → 重構 cmd_modules/ 下的模組
-├── [zone_2] → 重構 components/ 下的元件
-└── [zone_3] → 重構 lib/ 下的工具函數
-→ lead 驗證一致性，統一提交
-```
-
----
-
-### Legion
-
-**Native Team** — 即時溝通的完整團隊。
-
-使用 Claude Code 原生的 TeamCreate 機制，建立持久化團隊。成員之間可互相通訊、即時協調。Legion 的核心價值不是「更多人」，而是「即時溝通」— 只在成員的工作互相影響、需要即時協調時使用。
-
-- 機制：`TeamCreate` + `SendMessage`
-- 成本：最高（持久化 context + 通訊開銷）
-- 適用：有順序依賴、回饋循環、或高度耦合的複雜任務
-- 可用 skill：`forge`（順序流水線）、`hive`（網狀即時協調）
-
-**核心價值**（Squad 做不到的事）：
-- 即時通知「我改了 X，你要更新」
-- 回饋循環（review → fix → re-review）
-- 順序依賴（A 做完 B 才開始）
-- 動態調整（做到一半改方向）
-
-```
-範例 1：Legion + forge（鍛造）
-Designer ──→ Implementer(s) ──→ Reviewer
-    ↑ 回饋修正 ←──────────────────↓
-→ 設計 → 打造 → 淬煉，有序且有品質把關
-
-範例 2：Legion + hive（蜂巢）
-Worker A ←→ Worker B
-   ↕           ↕
-Worker C ←→ Worker D
-→ 所有人即時互聯，任何變更即時同步
-```
-
----
-
-## 選擇指南
-
-| 問自己 | 答案 | 陣型 |
-|--------|------|------|
-| 任務簡單、目標明確？ | Yes | **Unit** |
-| 需要多角度分析？ | Yes | **Solo** |
-| 需要同時做多件事？ | Yes | **Squad** |
-| 有順序依賴或回饋循環？ | Yes | **Legion** (forge) |
-| 工作高度耦合、需即時協調？ | Yes | **Legion** (hive) |
-
 ---
 
 ## 啟動方式
 
-### Headless Mode（推薦）
-
-由 Formation Lead 配好任務後直接呼叫，subagent 不問問題：
-
 ```bash
-# Unit: 單一任務
-node .formation/tools/headless.js --skill=do --task="修正按鈕顏色"
+# Unit
+node .formation/tools/dispatch.js --skill=do --task=TASK_172 --dispatch-mode=subagent
 
-# Solo: 多視角分析
-node .formation/tools/headless.js --formation=solo --skill=strategy --task="評估快取方案"
+# Solo
+node .formation/tools/dispatch.js --formation=solo --skill=strategy --task=TASK_172 --dispatch-mode=subagent
 
-# Squad: 並行執行
-node .formation/tools/headless.js --formation=squad --skill=blitz --task=TASK_201
-
-# Legion: Agent Teams 即時協作
-node .formation/tools/headless.js --formation=legion --skill=forge --task=TASK_202
-
-# Dry run（只看 prompt，不啟動）
-node .formation/tools/headless.js --formation=legion --skill=forge --task=TASK_202 --dry-run
+# Codex harness / 子專案 / 只看 payload 不產生副作用
+node .formation/tools/dispatch.js --skill=do --task=TASK_172 --dispatch-mode=subagent --harness=codex
+node .formation/tools/dispatch.js --skill=do --task=TASK_172 --dispatch-mode=subagent --project-path <path>
+node .formation/tools/dispatch.js --skill=do --task=TASK_172 --dispatch-mode=subagent --dry-run
 ```
 
-### Dispatch Mode（互動式）
-
-```bash
-node .formation/tools/dispatch.js --skill=do --task=TASK_172
-```
+缺 `--dispatch-mode=subagent`、或指定 squad/legion skill，都會以非零 exit code 結束並印出原因。
 
 ---
 
@@ -158,31 +51,13 @@ node .formation/tools/dispatch.js --skill=do --task=TASK_172
 ```
 .formation/
 ├── README.md              # 本文件
-├── lead.yaml              # Formation Lead（陣型選擇器）
+├── lead.yaml              # Formation Lead
 ├── tools/
-│   ├── headless.js       # ⭐ 無頭啟動器（所有陣型）
-│   ├── dispatch.js        # CLI 入口（互動式）
+│   ├── dispatch.js        # CLI 入口（--dispatch-mode=subagent）
 │   ├── loader.js          # YAML/Task 載入
-│   ├── prompt.js          # Prompt 組裝（unit/solo/squad/legion）
-│   ├── runner.js          # Claude 進程管理（single + parallel）
-│   ├── logger.js          # Log 格式化
+│   ├── prompt.js          # Subagent prompt 組裝 + 傳輸前綴
+│   ├── post-complete.js   # 完成後 merge / 驗證
 │   └── utils.js           # 工具函數
-├── logs/                  # ⭐ 執行日誌（按陣型分目錄）
-│   ├── unit/
-│   ├── solo/
-│   ├── squad/
-│   └── legion/
-├── unit/                  # Unit 陣型定義
-│   ├── do.yaml            # 執行者
-│   ├── think.yaml         # 分析者
-│   └── plan.yaml          # 規劃者
-├── solo/                  # Solo 陣型定義（含視角集）
-│   ├── strategy.yaml      # 策略分析（6 視角）
-│   └── diagnosis.yaml     # 問題診斷（4 視角）
-├── squad/                 # Squad 陣型定義（含協作模板）
-│   ├── blitz.yaml         # 通用並行拆分
-│   └── sweep.yaml         # 同規則多範圍掃蕩
-└── legion/                # Legion 陣型定義（含溝通模式）
-    ├── forge.yaml         # 順序流水線（設計→打造→淬煉）
-    └── hive.yaml          # 網狀即時協調（全連接）
+├── unit/                  # do / think / plan
+└── solo/                  # strategy / diagnosis
 ```

package/core/.formation/bifrost/codex-doctor.js

@@ -40,12 +40,47 @@ function writeIfChanged(f, text) {
   return 'written';
 }
 
+// Global Codex instructions (~/.codex/AGENTS.md, read by every Codex session): a marked Kenaz block,
+// so Codex agents know how to report Kenaz problems (wish / field report) like Claude's /Ansuz does.
+// Only the text between the markers is ours; the user's own content is never touched.
+const AGENTS_BEGIN = '<!-- kenaz:begin (managed by kenaz install; edits here are overwritten) -->';
+const AGENTS_END = '<!-- kenaz:end -->';
+function agentsBlock() {
+  return [AGENTS_BEGIN, '## Kenaz',
+    '- Kenaz tools come from the `kenaz-dashboard` MCP server (kenaz-server on 127.0.0.1:18080); `$kenaz status|init|ygg ...` runs the Kenaz CLI (needs network access to 127.0.0.1).',
+    '- When Kenaz itself blocks or degrades the work (a tool/hook/install/peer/dispatch failure, wrong data, missing capability), call `kenaz_wish_create` BEFORE working around it:',
+    '  projectPath = this project; scope = `kenaz` (Kenaz problem) or `project`; wish_type = `bug` | `feature` | `question`;',
+    '  content = one-line repro + expected vs actual + versions (`npx kenaz doctor` lines) + session id. Never paste keys or tokens.',
+    '  A scope=kenaz wish is sent to the Kenaz team as a field report. Report each problem once, then finish the work with the workaround and tell the user the wish was filed.',
+    AGENTS_END].join('\n');
+}
+function withoutAgentsBlock(text) {
+  const a = text.indexOf(AGENTS_BEGIN), b = text.indexOf(AGENTS_END);
+  if (a < 0 || b < a) return text;
+  return (text.slice(0, a) + text.slice(b + AGENTS_END.length)).replace(/\n{3,}/g, '\n\n').trim() + '\n';
+}
+function installAgentsBlock() {
+  const f = path.join(codexHome(), 'AGENTS.md');
+  const cur = fs.existsSync(f) ? fs.readFileSync(f, 'utf8') : '';
+  const base = withoutAgentsBlock(cur).trim();
+  return writeIfChanged(f, (base ? base + '\n\n' : '') + agentsBlock() + '\n');
+}
+function removeAgentsBlock(dryRun) {
+  const f = path.join(codexHome(), 'AGENTS.md');
+  if (!fs.existsSync(f)) return 'absent';
+  const cur = fs.readFileSync(f, 'utf8');
+  if (!cur.includes(AGENTS_BEGIN)) return 'absent';
+  if (!dryRun) { const rest = withoutAgentsBlock(cur); if (rest.trim()) fs.writeFileSync(f, rest); else fs.rmSync(f, { force: true }); }
+  return 'removed';
+}
+
 function installPrompts(core) {
   const f = path.join(codexHome(), 'prompts', 'kenaz.md');
   const skill = path.join(codexHome(), 'skills', 'kenaz', 'SKILL.md');
   const a = writeIfChanged(f, promptText(core));
   const b = writeIfChanged(skill, skillText(core));
-  return { file: f, skill, action: a === 'unchanged' && b === 'unchanged' ? 'unchanged' : 'written' };
+  const c = installAgentsBlock();
+  return { file: f, skill, action: [a, b, c].every((x) => x === 'unchanged') ? 'unchanged' : 'written' };
 }
 
 // Per event: is our shim registered, and does codex hold a trusted_hash for it (hooks.state)?
@@ -95,7 +130,7 @@ function diagnose() {
   return { trust, delivery_mode: deliveryMode(trust), ok: notes.length === 0, notes };
 }
 
-module.exports = { promptText, skillText, installPrompts, hookTrust, deliveryMode, diagnose, SHIM_REL, EVENTS };
+module.exports = { promptText, skillText, installPrompts, installAgentsBlock, removeAgentsBlock, agentsBlock, hookTrust, deliveryMode, diagnose, SHIM_REL, EVENTS };
 
 if (require.main === module) {
   if (process.argv.includes('--install-prompts')) console.log(JSON.stringify(installPrompts()));

package/core/.formation/bifrost/codex-doctor.test.js

@@ -49,3 +49,21 @@ test('shim honours Kenaz mode: off silent, full control still runs', () => {
   assert.strictEqual(off.stderr.includes('event='), false);
   assert.ok(full.stderr.includes('event=SessionStart')); // control: hook does run when not off
 });
+
+test('global AGENTS.md gets one managed Kenaz block (wish / field report guidance); user text kept; removal leaves the rest', () => {
+  const home = fs.mkdtempSync(path.join(os.tmpdir(), 'cx-agents-'));
+  process.env.CODEX_HOME = home;
+  const f = path.join(home, 'AGENTS.md');
+  fs.writeFileSync(f, '# My own Codex rules\nAlways be terse.\n');
+  D.installAgentsBlock();
+  D.installAgentsBlock(); // idempotent: still one block
+  const t = fs.readFileSync(f, 'utf8');
+  assert.match(t, /Always be terse\./);
+  assert.strictEqual(t.split('kenaz:begin').length - 1, 1);
+  assert.match(t, /kenaz_wish_create/);
+  assert.strictEqual(D.removeAgentsBlock(false), 'removed');
+  const after = fs.readFileSync(f, 'utf8');
+  assert.match(after, /Always be terse\./);
+  assert.doesNotMatch(after, /kenaz:begin|kenaz_wish_create/);
+  delete process.env.CODEX_HOME;
+});

package/core/.formation/bifrost/launch.js

@@ -305,7 +305,7 @@ function writeOverride(prompt, bootContext) {
 
   fs.writeFileSync(OVERRIDE_PATH, content, 'utf8');
 
-  // Write adapter signal file so headless.js knows to route through Bifröst
+  // Write adapter signal file (read by session.js and the Dashboard bifrost-active route)
   const signalPath = path.join(ROOT, '.formation', '.bifrost-active');
   fs.writeFileSync(signalPath, JSON.stringify({ adapter: 'openai', specialist: SPECIALIST, pid: process.pid, started: new Date().toISOString() }));
 

package/core/.formation/bifrost/openai/codex-hook-shim.js

@@ -123,6 +123,11 @@ async function main() {
   try { mode = require(path.resolve(ROOT, 'plugins/kenaz/hooks/mode.js')).resolveMode(p.cwd || process.cwd()); } catch {}
   if (mode === 'off') process.exit(0);
   console.error('[codex-hook-shim] event=' + ev);
+  // Register this project with kenaz-server (idempotent, no-op when known): Codex sessions never run
+  // the Claude turn-context hook, so a Codex-only machine stayed out of its room (field report).
+  const registering = (ev === 'SessionStart' || ev === 'UserPromptSubmit')
+    ? (() => { try { const r = resolvePeerProjectRoot(p.cwd || process.cwd()); return r ? peerRequest('POST', '/api/projects/register', { projectPath: r }) : null; } catch { return null; } })()
+    : null;
   const payload = normalizeHookPayload(p);
   if (ev === 'UserPromptSubmit') {
     payload.specialist = p.specialist || payload.specialist;
@@ -164,6 +169,7 @@ async function main() {
     }).catch(() => {}).finally(() => process.exit(0));
     return; // exit handled by finally above
   }
+  if (registering) await registering; // bounded by PEER_TIMEOUT_MS; fail-open
   process.exit(0);
 }
 

package/core/.formation/bifrost/openai/codex-hook-shim.test.js

@@ -33,7 +33,17 @@ async function fixture({ project, cwd = path.resolve('hook-cwd'), reject = false
         readFileSync: () => { throw new Error('no real state reads'); },
       };
       // TASK_2299 peer pull deps; no KENAZ_PEER_PULL in these fixtures, so no request is expected.
-      if (id === 'http') return { request: () => { effects.http.push('request'); assert.fail('unexpected peer request'); } };
+      // The only request allowed here is the idempotent project registration (SessionStart /
+      // UserPromptSubmit); the fake fails it at once, like a server that is down (fail-open).
+      if (id === 'http') return { request: (opts) => {
+        if (opts && opts.method === 'POST' && opts.path === '/api/projects/register') {
+          effects.http.push('register');
+          const handlers = {};
+          const req = { on: (ev, fn) => { handlers[ev] = fn; return req; }, destroy: () => {}, end: () => { if (handlers.error) handlers.error(new Error('down')); } };
+          return req;
+        }
+        effects.http.push('request'); assert.fail('unexpected peer request');
+      } };
       if (id.endsWith('_peer-project-root.js')) return { resolvePeerProjectRoot: dir => dir };
       if (id === 'child_process') return { execFileSync: () => assert.fail('unexpected child') };
       effects.modules.push(id);

package/core/.formation/bifrost/setup-codex.js

@@ -231,6 +231,9 @@ function uninstall(options = {}) {
   if (res.hooks === 'removed' && !dryRun) fs.writeFileSync(cfg, out.join('\n').replace(/\n{3,}/g, '\n\n'), 'utf8');
   const prompt = path.join(getCodexHome(), 'prompts', 'kenaz.md');
   if (fs.existsSync(prompt)) { res.prompt = 'removed'; if (!dryRun) fs.rmSync(prompt, { force: true }); }
+  const skillDir = path.join(getCodexHome(), 'skills', 'kenaz');
+  if (fs.existsSync(skillDir)) { res.skill = 'removed'; if (!dryRun) fs.rmSync(skillDir, { recursive: true, force: true }); }
+  try { res.agents_md = require('./codex-doctor').removeAgentsBlock(dryRun); } catch (_) { /* doctor optional */ }
   log((dryRun ? 'dry-run: ' : '') + 'codex uninstall ' + JSON.stringify(res));
   return { success: true, ...res };
 }

package/core/.formation/native/claude/README.md

@@ -51,7 +51,7 @@ no surprise dependencies.
 4. When the user picks an entry, the id is written into
    `.kenaz/dashboard-models.json` via
    `POST /api/dashboard/settings/models` and consumed by
-   `kenaz_dispatch` / `SpecialistPanel.handleLaunch`.
+   `SpecialistPanel.handleLaunch`.
 
 ## Adding a new model
 

package/core/.formation/role-map.yaml

@@ -3,8 +3,8 @@
 # Amelia 判斷 role 時參考此表，dispatch 時用此表解析 --role 路徑
 #
 # Usage:
-#   node .formation/tools/headless-v2.js --base=do --role=developer --task=TASK_XXX
-#   headless-v2 會查此表找到 skill_path → 載入該 YAML 的 role context
+#   node .formation/tools/dispatch.js --skill=do --task=TASK_XXX --dispatch-mode=subagent
+#   （此表僅供 Amelia 判斷 role 參考；dispatch.js 不讀取它。headless-v2 已退役）
 
 version: "2.0"
 
@@ -259,7 +259,7 @@ roles:
       - 新功能開發
 
 # ─────────────────────────────────────────
-# Base Skills（headless-v2 的 --base 選項）
+# Base Skills（歷史：原 headless-v2 的 --base 選項）
 # ─────────────────────────────────────────
 
 bases:

package/core/.formation/spec/task_operations.parity.test.js

@@ -28,7 +28,6 @@ const PROJECT_ROOT = path.resolve(SPEC_DIR, '../..');
 const FILES = {
   taskApi:     path.join(PROJECT_ROOT, '.collaboration/core/task-api.js'),
   postComplete: path.join(PROJECT_ROOT, '.formation/tools/post-complete/staging.js'),
-  headless:    path.join(PROJECT_ROOT, '.formation/tools/headless.js'),
   kenazRs:     path.join(PROJECT_ROOT, 'dashboard/src-tauri/src/infrastructure/http_server/routes/mcp_tools/kenaz.rs'),
   spec:        path.join(SPEC_DIR, 'task_operations.yaml'),
 };