kenaz 0.3.2 → 0.3.3

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

@@ -1589,17 +1589,12 @@ class TaskAPI {
       console.warn('WARNING: overriding acceptance_criteria required for code-touching task via --force');
     }
 
-    // 品質閘門：檢查任務內容是否足夠豐富
+    // 品質提示（2026-10-10 起只警告、不阻擋；ANSUZ_SLIM_PLAN）：數量門檻擋卡的成本高於價值。
+    // 仍強制的只有上方「改到程式碼的卡至少一條 acceptance_criteria」。
     if (!options.force) {
       const quality = this.validateTaskQuality(taskData);
       if (!quality.valid) {
-        const msg = [
-          '❌ 任務品質不足，無法建立：',
-          ...quality.warnings.map(w => `  - ${w}`),
-          '',
-          '提示：補齊欄位後重試，或使用 --force 強制建立'
-        ].join('\n');
-        throw new Error(msg);
+        console.warn(['⚠️ 任務內容偏少（仍會建立）：', ...quality.warnings.map(w => `  - ${w}`)].join('\n'));
       }
     }
 

package/core/.formation/tests/hello.txt

@@ -1,2 +1,2 @@
-Hello World
-Canary OK
+Hello World
+Canary OK

package/core/.formation/tools/prompt.js

@@ -324,6 +324,12 @@ function buildPrompt(skillDef, taskInput, taskData, options = {}) {
     legacy: buildLegacyPrompt,
   };
 
+  // TASK_2391: worktree/direct subagent dispatch gets the short template, not the
+  // full Formation prompt. squad/legion/legacy and non-subagent paths are unchanged.
+  if (options.isSubagent && (formation === 'unit' || formation === 'solo')) {
+    return buildSubagentPrompt(skillDef, taskInput, taskData, options);
+  }
+
   const builder = builders[formation];
   if (!builder) {
     throw new Error(`Unknown formation: ${formation}. Expected: ${Object.keys(builders).join(', ')}`);
@@ -360,6 +366,51 @@ function buildUnitPrompt(skillDef, taskInput, taskData, options = {}) {
   return lines.join('\n');
 }
 
+// ─────────────────────────────────────────
+// Subagent：短範本（TASK_2391）
+// ─────────────────────────────────────────
+
+/**
+ * Short prompt for Agent-tool subagent dispatch (both harnesses): task card,
+ * commit command, verification expectation, report format. The worktree hard
+ * rules are prepended by dispatch.js (SUBAGENT_PREFIX et al.). No Code
+ * Minimalism / File Budget / Known Failures / Search Tool Selection / Behavior /
+ * Expected Output / Progress Note; Rust check only when the card has Rust scope.
+ */
+function buildSubagentPrompt(skillDef, taskInput, taskData, options = {}) {
+  const lines = [];
+  appendProjectContext(lines, options);
+  appendTask(lines, taskInput, taskData, { ...options, compactCard: true });
+
+  const isIsolated = !!((options.isSubagent && !options.isCrossProject) || options.isWorktree);
+  const taskId = options.taskId || extractTaskId(taskData) || '{task_id}';
+  lines.push('## Commit');
+  lines.push(`Command: ${buildCommitCommand(isIsolated ? '-A' : '<only the files you edited>', `[${taskId}] task completed`)}`);
+  lines.push(isIsolated
+    ? 'Commit right after editing, before verifying. A failing commit: report it loudly. Add finds nothing after an Edit = you edited the main repo path: check pwd, redo in the worktree.'
+    : 'Shared working tree: stage only files you edited. Commit right after editing, before verifying. A failing commit: report it loudly.');
+  lines.push('');
+  appendRustCheckReminder(lines, taskData, options, isIsolated);
+
+  lines.push('## Verify and report');
+  lines.push('Run the tests the card names (narrow, not the full suite); say what you did not verify.');
+  const onBlocked = skillDef.collaboration && skillDef.collaboration.on_blocked;
+  if (onBlocked && onBlocked.run) {
+    lines.push(`Blocked: \`${buildTaskApiRewriter(options)(onBlocked.run).replace(/\{task_id\}/g, taskId)}\` and explain.`);
+  }
+  lines.push('Final report <= 20 lines: files touched, tests run, commit sha, unverified items.');
+  lines.push('');
+  appendDispatchOverrides(lines, taskData);
+  return lines.join('\n');
+}
+
+function extractTaskId(taskData) {
+  try {
+    const parsed = typeof taskData === 'string' ? JSON.parse(taskData) : taskData;
+    return (parsed && parsed.id) || null;
+  } catch { return null; }
+}
+
 // ─────────────────────────────────────────
 // Solo：一個 agent 裝備多視角，自主切換
 // ─────────────────────────────────────────
@@ -1014,7 +1065,7 @@ function appendTask(lines, taskInput, taskData, options = {}) {
       // Structured task injection — give agent everything it needs
       lines.push(`**Task ID**: ${parsed.id}`);
       lines.push(`**Title**: ${parsed.title || 'N/A'}`);
-      if (parsed._file_path) {
+      if (parsed._file_path && !options.compactCard) {
         lines.push(`**Task File**: ${parsed._file_path}`);
       }
 
@@ -1035,9 +1086,11 @@ function appendTask(lines, taskInput, taskData, options = {}) {
       if (parsed.description) {
         lines.push(`**Description**: ${parsed.description.trim()}`);
       }
-      if (parsed.priority) lines.push(`**Priority**: ${parsed.priority}`);
-      if (parsed.complexity) lines.push(`**Complexity**: ${parsed.complexity}`);
-      if (parsed.role) lines.push(`**Role**: ${parsed.role}`);
+      if (!options.compactCard) {
+        if (parsed.priority) lines.push(`**Priority**: ${parsed.priority}`);
+        if (parsed.complexity) lines.push(`**Complexity**: ${parsed.complexity}`);
+        if (parsed.role) lines.push(`**Role**: ${parsed.role}`);
+      }
 
       // Resolve scope_paths to absolute paths
       const scopePaths = parsed.scope_paths || [];
@@ -1988,7 +2041,7 @@ const subagentAsyncRules = (commitRuleNo) => `12. **⚠️ 你送出訊息就等
 // separate from subagentAsyncRules() above: that one still backs
 // SUBAGENT_PREFIX_DIRECT verbatim (untouched, out of TASK_1978 scope).
 const WORKTREE_DISPATCH_HARD_RULES = `2. CLAUDE.md 生效；完成輸出結果；卡住回報錯誤並結束。
-3. 改完立刻 commit（## Workflow，已排除 telemetry）－不等驗證；禁 push/切 branch/刪 worktree/stash/reset --hard。
+3. 改完立刻 commit（## Commit，已排除 telemetry）－不等驗證；禁 push/切 branch/刪 worktree/stash/reset --hard。
 4. 送出訊息=結束；禁長建置/全測試（commit 後報未驗證，Rust 交 Ansuz）；禁 sleep 輪詢；禁用 image name 殺行程（只殺自己 PID）。
 5. 只做指定任務；不讀任務目錄；只用 task-api.js；worktree 禁 complete。`;
 

package/core/.formation/tools/prompt.test.js

@@ -873,3 +873,32 @@ test('memory frozen (2026-10-10): a caller without __forceAlaya renders no Alaya
   assert.equal(called, false);
   assert.equal(lines.join('\n').includes('Process lessons (Alaya)'), false);
 });
+
+// ── TASK_2391: subagent dispatch prompt is a short template ─────────────
+function loadDoSkill() {
+  return require('js-yaml').load(fs.readFileSync(path.join(__dirname, '..', 'unit', 'do.yaml'), 'utf8'));
+}
+
+test('TASK_2391: subagent prompt keeps card + commit rule + report, drops boilerplate sections', () => {
+  const card = {
+    id: 'TASK_9001', title: 'T', description: 'Desc', scope_paths: ['src/a.js'],
+    requirements: ['REQ-ONE'], acceptance_criteria: ['AC-ONE'], technical_notes: ['NOTE-ONE'],
+    complexity: 'complex', rigor: 'high',
+  };
+  const body = buildPrompt(loadDoSkill(), 'TASK_9001', JSON.stringify(card), { isSubagent: true, taskId: 'TASK_9001' });
+  for (const must of ['REQ-ONE', 'AC-ONE', 'NOTE-ONE', 'src/a.js', '--no-verify -m "[TASK_9001] task completed"', '<= 20 lines', 'commit sha', 'did not verify']) {
+    assert.ok(body.includes(must), `missing: ${must}`);
+  }
+  for (const gone of ['Code Minimalism', 'File Budget', 'Known Failures', 'Search Tool Selection', '## Behavior', '## Expected Output', 'Progress Note', 'Working contract', '## Rust check']) {
+    assert.ok(!body.includes(gone), `should be gone: ${gone}`);
+  }
+  assert.ok(body.length < 2500, `body too long: ${body.length}`);
+});
+
+test('TASK_2391: subagent prompt gets the Rust check only for a Rust-scoped card; non-subagent path unchanged', () => {
+  const rustCard = JSON.stringify({ id: 'TASK_9002', title: 'R', scope_paths: ['dashboard/src-tauri/src/x.rs'] });
+  const withRust = buildPrompt(loadDoSkill(), 'TASK_9002', rustCard, { isSubagent: true, taskId: 'TASK_9002', rustCoreCheck: () => true });
+  assert.ok(withRust.includes('## Rust check (once, after commit)'));
+  const formation = buildPrompt(loadDoSkill(), 'TASK_9002', rustCard, {});
+  assert.ok(formation.includes('## Code Minimalism') && formation.includes('## Workflow'));
+});

package/core/.kenaz/claude-hooks-manifest.json

@@ -18,7 +18,7 @@
       {
         "marker": "kenaz-hook-user-prompt-runner",
         "command": "node -e \"const d=process.env.CLAUDE_PROJECT_DIR;process.chdir(d);require(d+'/.claude/hooks/_run-user-prompt.js')\"",
-        "description": "TASK_1988: single-process runner for handoff-staleness, fatigue-check, daemon-outbox, turn-context, task-bridge, lease-touch, stream-delta (was 6-8 separate node processes per turn)"
+        "description": "TASK_1988: single-process runner for daemon-outbox, turn-context, task-bridge (TASK_2392 froze handoff-staleness, fatigue-check, lease-touch, stream-delta; was 6-8 separate node processes per turn)"
       }
     ],
     "PreToolUse": [
@@ -39,21 +39,6 @@
         "marker": "kenaz-hook-task-bridge-post-tool",
         "matcher": "TaskCreate|TaskUpdate",
         "command": "node -e \"const d=process.env.CLAUDE_PROJECT_DIR;process.chdir(d);require(d+'/.claude/hooks/task-bridge.js')\""
-      },
-      {
-        "marker": "kenaz-hook-handoff-snapshot-on-commit",
-        "matcher": "Bash",
-        "command": "node -e \"const d=process.env.CLAUDE_PROJECT_DIR;process.chdir(d);require(d+'/.claude/hooks/handoff-snapshot-on-commit.js')\""
-      },
-      {
-        "marker": "kenaz-hook-handoff-snapshot-on-question",
-        "matcher": "AskUserQuestion",
-        "command": "node -e \"const d=process.env.CLAUDE_PROJECT_DIR;process.chdir(d);require(d+'/.claude/hooks/handoff-snapshot-on-question.js')\""
-      },
-      {
-        "marker": "kenaz-hook-handoff-snapshot-on-decision",
-        "matcher": "mcp__kenaz-dashboard__synapse_inscribe",
-        "command": "node -e \"const d=process.env.CLAUDE_PROJECT_DIR;process.chdir(d);require(d+'/.claude/hooks/handoff-snapshot-on-decision.js')\""
       }
     ]
   },
@@ -114,6 +99,21 @@
       "marker": "kenaz-hook-synapse-release-on-session-end",
       "command": "node -e \"const d=process.env.CLAUDE_PROJECT_DIR;process.chdir(d);require(d+'/.claude/hooks/synapse-release-on-session-end.js')\"",
       "retired_by": "TASK_2335"
+    },
+    {
+      "marker": "kenaz-hook-handoff-snapshot-on-commit",
+      "command": "node -e \"const d=process.env.CLAUDE_PROJECT_DIR;process.chdir(d);require(d+'/.claude/hooks/handoff-snapshot-on-commit.js')\"",
+      "retired_by": "TASK_2392"
+    },
+    {
+      "marker": "kenaz-hook-handoff-snapshot-on-question",
+      "command": "node -e \"const d=process.env.CLAUDE_PROJECT_DIR;process.chdir(d);require(d+'/.claude/hooks/handoff-snapshot-on-question.js')\"",
+      "retired_by": "TASK_2392"
+    },
+    {
+      "marker": "kenaz-hook-handoff-snapshot-on-decision",
+      "command": "node -e \"const d=process.env.CLAUDE_PROJECT_DIR;process.chdir(d);require(d+'/.claude/hooks/handoff-snapshot-on-decision.js')\"",
+      "retired_by": "TASK_2392"
     }
   ]
 }