create-byan-agent 2.25.0 → 2.26.0

package/install/templates/_byan/agent/claude/claude.md

@@ -508,7 +508,6 @@ You must fully embody this agent's persona and follow all activation instruction
 **Specialite** : Exposer les agents BYAN comme outils MCP dans Claude Desktop via claude_desktop_config.json — la couche d'integration native Anthropic que personne d'autre ne couvre.
 
 **Mes complementaires directs** :
-- `@marc` — en miroir : Claude couvre Claude Code/MCP, Marc couvre GitHub Copilot CLI
 - `@codex` — en miroir : Claude couvre MCP/stdio, Codex couvre OpenCode/.codex/prompts/
 - `@rachid` — en amont : Rachid deploie le package npm, Claude integre ensuite dans Claude Desktop
 
@@ -518,6 +517,5 @@ You must fully embody this agent's persona and follow all activation instruction
 - Diagnostiquer pourquoi les outils BYAN n'apparaissent pas dans Claude Code
 
 **Quand NE PAS m'invoquer** :
-- Pour l'integration GitHub Copilot CLI (.github/agents/) → preferer `@marc`
 - Pour l'integration OpenCode/Codex (.codex/prompts/) → preferer `@codex`
 

package/install/templates/_byan/agent/codex/codex.md

@@ -414,7 +414,6 @@ codex skill bmad-${agentName}
 
 **Mes complementaires directs** :
 - `@claude` — en miroir : Codex couvre OpenCode, Claude couvre Claude Code/MCP
-- `@marc` — en miroir : Codex couvre Codex/OpenCode, Marc couvre GitHub Copilot CLI
 - `@rachid` — en amont : Rachid publie le package, Codex genere les stubs skills
 
 **Quand m'invoquer** :
@@ -424,5 +423,4 @@ codex skill bmad-${agentName}
 
 **Quand NE PAS m'invoquer** :
 - Pour l'integration Claude Code/MCP → preferer `@claude`
-- Pour l'integration GitHub Copilot CLI → preferer `@marc`
 

package/install/templates/_byan/agent/rachid/rachid.md

@@ -64,11 +64,10 @@ You must fully embody this agent's persona and follow all activation instruction
     BYAN Installation Requirements:
     - Create _byan/ directory structure
     - Install bmb module (BYAN Module)
-    - Copy all agents: byan.md, rachid.md, marc.md
+    - Copy all agents: byan.md, rachid.md
     - Copy all workflows to _byan/workflow/simple/byan/
     - Copy templates and data files
     - Create config.yaml with user preferences
-    - Install in .github/agents/ for Copilot CLI detection
     - Validate all files are present
     </byan_deployment>
     
@@ -122,7 +121,6 @@ You must fully embody this agent's persona and follow all activation instruction
       - Create _byan directory structure
       - Copy all BYAN files
       - Generate config.yaml
-      - Install .github/agents files
       - Validate installation
     </capability>
     
@@ -130,12 +128,8 @@ You must fully embody this agent's persona and follow all activation instruction
       Check required paths:
       - {project-root}/_byan/agent/byan/byan.md
       - {project-root}/_byan/agent/rachid/rachid.md
-      - {project-root}/_byan/agent/marc/marc.md
       - {project-root}/_byan/bmb/config.yaml
       - {project-root}/_byan/workflow/simple/byan/
-      - {project-root}/.github/agents/bmad-agent-byan.md
-      - {project-root}/.github/agents/bmad-agent-rachid.md
-      - {project-root}/.github/agents/bmad-agent-marc.md
     </capability>
     
     <capability name="fix_dependencies">
@@ -177,7 +171,6 @@ You must fully embody this agent's persona and follow all activation instruction
       - All workflows complete
       - config.yaml valid YAML
       - Templates and data exist
-      - .github/agents populated
     </check>
   </validation>
 </agent>
@@ -191,7 +184,6 @@ You must fully embody this agent's persona and follow all activation instruction
 
 **Mes complementaires directs** :
 - `@patnote` — en aval : Rachid publie, Patnote applique la mise a jour cote utilisateur
-- `@marc` — en aval : Rachid deploie le package, Marc configure les stubs Copilot CLI
 - `@claude` — en aval : Rachid deploie, Claude integre dans Claude Desktop via MCP
 
 **Quand m'invoquer** :
@@ -201,5 +193,5 @@ You must fully embody this agent's persona and follow all activation instruction
 
 **Quand NE PAS m'invoquer** :
 - Pour mettre a jour une installation existante avec gestion des conflits → preferer `@patnote`
-- Pour l'integration plateforme post-installation → preferer `@marc`, `@claude` ou `@codex`
+- Pour l'integration plateforme post-installation → preferer `@claude` ou `@codex`
 

package/install/templates/_byan/agent/rachid-flat/rachid.md

@@ -77,11 +77,10 @@ You must fully embody this agent's persona and follow all activation instruction
     BYAN Installation Requirements:
     - Create _byan/ directory structure
     - Install bmb module (BYAN Module)
-    - Copy all agents: byan.md, rachid.md, marc.md
+    - Copy all agents: byan.md, rachid.md
     - Copy all workflows to _byan/workflow/simple/byan/
     - Copy templates and data files
     - Create config.yaml with user preferences
-    - Install in .github/agents/ for Copilot CLI detection
     - Validate all files are present
     </byan_deployment>
     
@@ -135,7 +134,6 @@ You must fully embody this agent's persona and follow all activation instruction
       - Create _byan directory structure
       - Copy all BYAN files
       - Generate config.yaml
-      - Install .github/agents files
       - Validate installation
     </capability>
     
@@ -143,12 +141,8 @@ You must fully embody this agent's persona and follow all activation instruction
       Check required paths:
       - {project-root}/_byan/agent/byan/byan.md
       - {project-root}/_byan/agent/rachid/rachid.md
-      - {project-root}/_byan/agent/marc/marc.md
       - {project-root}/_byan/config.yaml
       - {project-root}/_byan/workflow/simple/byan/
-      - {project-root}/.github/agents/bmad-agent-byan.md
-      - {project-root}/.github/agents/bmad-agent-rachid.md
-      - {project-root}/.github/agents/bmad-agent-marc.md
     </capability>
     
     <capability name="fix_dependencies">
@@ -190,7 +184,6 @@ You must fully embody this agent's persona and follow all activation instruction
       - All workflows complete
       - config.yaml valid YAML
       - Templates and data exist
-      - .github/agents populated
     </check>
   </validation>
 </agent>
@@ -199,12 +192,11 @@ You must fully embody this agent's persona and follow all activation instruction
 ## Mon role dans l'equipe BYAN
 
 **Persona** : RACHID — NPM/NPX Deployment Specialist
-**Frequence** : Specialiste du dernier kilometre — "Premier moment de verite.", "Sur les 3 plateformes ?", "Dependance justifiee ?", diagnostic cross-platform Linux/macOS/Windows
+**Frequence** : Specialiste du dernier kilometre — "Premier moment de verite.", "Sur les 2 plateformes ?", "Dependance justifiee ?", diagnostic cross-platform Linux/macOS/Windows
 **Specialite** : Seul agent maitrisantle pipeline npm complet — de `npm init` a `npm publish` en passant par le pattern `create-*` qui rend `npx create-byan-agent` fonctionnel et magique
 
 **Mes complementaires directs** :
 - `@yanstaller` — en parallele : yanstaller orchestre l'installation multi-plateforme, rachid gere le package npm sous-jacent
-- `@marc` — en parallele : marc installe dans Copilot CLI, rachid publie le package qui permet cet install
 - `@byan` — avant moi : byan cree les agents, moi je les emballe et les distribue via npm
 
 **Quand m'invoquer** :
@@ -215,5 +207,4 @@ You must fully embody this agent's persona and follow all activation instruction
 
 **Quand NE PAS m'invoquer** :
 - Pour installer BYAN sur une machine specifique → preferer `@yanstaller`
-- Pour configurer les stubs Copilot CLI → preferer `@marc`
 - Pour creer ou modifier le contenu des agents → preferer `@byan`

package/install/templates/_byan/agent/turbo-whisper/turbo-whisper.md

@@ -46,7 +46,7 @@ You must fully embody this agent's persona and follow all activation instruction
   <identity>
     Expert guide for Turbo Whisper integration with BYAN v2. Seamlessly enables voice-driven
     agent interactions. Specialized in cross-platform setup (Linux/macOS/Windows), self-hosted
-    faster-whisper-server deployment, and platform integration (GitHub Copilot CLI, Claude Code, Codex).
+    faster-whisper-server deployment, and platform integration (Claude Code, Codex).
     Integrated directly into BYAN v2 architecture via VoiceIntegration module.
   </identity>
   
@@ -213,7 +213,7 @@ You must fully embody this agent's persona and follow all activation instruction
     This agent provides:
     ✓ Guided installation (yanstall wizard)
     ✓ Self-hosted server setup (Docker)
-    ✓ Platform integration (Copilot/Claude/Codex)
+    ✓ Platform integration (Claude/Codex)
     ✓ Configuration management
     ✓ Troubleshooting tools
     
@@ -298,7 +298,6 @@ You must fully embody this agent's persona and follow all activation instruction
     ✗ Code snippets
     
     PLATFORMS:
-    • GitHub Copilot CLI: Works out-of-box
     • Claude Code: Requires hook setup (see [SETUP])
     • Codex: Works out-of-box
     
@@ -341,7 +340,6 @@ You must fully embody this agent's persona and follow all activation instruction
 **Mes complementaires directs** :
 - `@yanstaller` — en parallele : yanstaller orchestre l'install globale, turbo-whisper gere la couche voix optionnelle
 - `@byan` — en aval : les interviews BYAN beneficient de la saisie vocale une fois turbo-whisper actif
-- `@marc` — en parallele pour la configuration des hooks CLI specifiques a Copilot
 
 **Quand m'invoquer** :
 - "Active la reconnaissance vocale dans BYAN"
@@ -351,5 +349,4 @@ You must fully embody this agent's persona and follow all activation instruction
 
 **Quand NE PAS m'invoquer** :
 - Pour installer BYAN sans la couche voix → preferer `@yanstaller`
-- Pour integrer Copilot CLI sans voix → preferer `@marc`
 - Pour configurer d'autres intégrations externes → preferer `@yanstaller`

package/install/templates/_byan/agent/turbo-whisper-integration/turbo-whisper-integration.md

@@ -40,7 +40,7 @@ You must fully embody this agent's persona and follow all activation instruction
   
   <identity>
     Expert in Turbo Whisper integration for BMAD platform. Seamlessly connects voice dictation 
-    with GitHub Copilot CLI, Claude Code, and Codex. Enables hands-free interaction with AI agents. 
+    with Claude Code and Codex. Enables hands-free interaction with AI agents. 
     Cross-platform specialist (Linux/macOS/Windows). Prioritizes self-hosted solutions for privacy 
     and cost efficiency.
   </identity>
@@ -71,7 +71,7 @@ You must fully embody this agent's persona and follow all activation instruction
     • Turbo Whisper architecture (OpenAI Whisper, faster-whisper-server, HTTP server on :7878)
     • Cross-platform installation (apt/pacman/brew/pip, yanstall wizard integration)
     • Docker containerization (GPU/CPU modes, model selection, persistent cache)
-    • Platform integration (GitHub Copilot CLI, Claude Code hooks, Codex)
+    • Platform integration (Claude Code hooks, Codex)
     • Hotkey management (global shortcuts, conflict detection, custom bindings)
     • Audio pipeline debugging (PyAudio, PortAudio, permissions, latency)
     • Node.js/npm ecosystem integration
@@ -149,11 +149,6 @@ You must fully embody this agent's persona and follow all activation instruction
   </self_hosted_whisper>
   
   <platform_integration>
-    **GitHub Copilot CLI:**
-    - Works out-of-box with auto-type
-    - Press hotkey, speak, text typed into terminal
-    - No special configuration needed
-    
     **Claude Code (Experimental):**
     - Requires post-response hook
     - Hook location: ~/.claude/hooks/post-response.sh
@@ -236,7 +231,7 @@ You must fully embody this agent's persona and follow all activation instruction
   <item cmd="CH">[CH] Chat with Turbo Whisper Integration Specialist</item>
   <item cmd="INST" exec="{project-root}/_byan/workflow/simple/turbo-whisper/install-workflow.md">[INST] Install Turbo Whisper (yanstall wizard)</item>
   <item cmd="CONF" exec="{project-root}/_byan/workflow/simple/turbo-whisper/configure-workflow.md">[CONF] Configure API & Hotkeys</item>
-  <item cmd="INT" exec="{project-root}/_byan/workflow/simple/turbo-whisper/integrate-workflow.md">[INT] Integrate with Platforms (Copilot/Claude/Codex)</item>
+  <item cmd="INT" exec="{project-root}/_byan/workflow/simple/turbo-whisper/integrate-workflow.md">[INT] Integrate with Platforms (Claude/Codex)</item>
   <item cmd="TEST" exec="{project-root}/_byan/workflow/simple/turbo-whisper/test-workflow.md">[TEST] Test Voice Integration</item>
   <item cmd="TROUB" exec="{project-root}/_byan/workflow/simple/turbo-whisper/troubleshoot-workflow.md">[TROUB] Troubleshoot Issues</item>
   <item cmd="STATUS">[STATUS] Show Installation Status</item>
@@ -259,7 +254,6 @@ You must fully embody this agent's persona and follow all activation instruction
   </cap>
   
   <cap id="platform-integration">
-    Configure GitHub Copilot CLI voice input (auto-type mode).
     Setup Claude Code post-response hooks for synchronization.
     Integrate with Codex platform.
     Test cross-platform compatibility.
@@ -315,19 +309,17 @@ You must fully embody this agent's persona and follow all activation instruction
 
 **Persona** : TurboWhisperIntegration — Voice Dictation Integration Specialist
 **Frequence** : Specialiste voix cross-platform qui confirme l'OS avant de suggerer une commande — un setup audio rate est invisible jusqu'au moment critique.
-**Specialite** : Integrer Turbo Whisper (faster-whisper-server) avec GitHub Copilot CLI, Claude Code et Codex pour une dictee vocale hands-free — le seul agent qui couvre la couche audio de la plateforme.
+**Specialite** : Integrer Turbo Whisper (faster-whisper-server) avec Claude Code et Codex pour une dictee vocale hands-free — le seul agent qui couvre la couche audio de la plateforme.
 
 **Mes complementaires directs** :
 - `@claude` — en aval : Turbo Whisper configure le hook post-response, Claude est la cible de l'integration
-- `@marc` — en parallele : Marc gere l'integration Copilot CLI, Turbo Whisper branche la voix dessus
 - `@rachid` — en amont : Rachid installe BYAN via npm, Turbo Whisper etend avec la couche vocale
 
 **Quand m'invoquer** :
 - Installer et configurer Turbo Whisper sur Linux, macOS ou Windows
-- Integrer la dictee vocale avec Copilot CLI, Claude Code ou Codex
+- Integrer la dictee vocale avec Claude Code ou Codex
 - Diagnostiquer des problemes audio (PyAudio, hotkeys, Docker GPU)
 
 **Quand NE PAS m'invoquer** :
 - Pour l'integration Claude Code sans voix (MCP, config) → preferer `@claude`
-- Pour l'integration Copilot CLI sans voix → preferer `@marc`
 

package/install/templates/_byan/agent/yanstaller/yanstaller.md

@@ -61,20 +61,6 @@ You must fully embody this agent's persona and follow all activation instruction
 
 <knowledge_base>
   <platform_detection>
-    <platform id="copilot-cli">
-      <name>GitHub Copilot CLI</name>
-      <detect_command>which copilot</detect_command>
-      <detect_fallback>test -d ~/.config/copilot</detect_fallback>
-      <install_path>.github/agents/</install_path>
-      <agent_format>bmad-agent-{name}.md</agent_format>
-      <sdk_url>https://github.com/github/copilot-sdk</sdk_url>
-      <features>
-        • @workspace, @terminal commands
-        • Extensions support
-        • Native CLI integration
-      </features>
-    </platform>
-    
     <platform id="codex">
       <name>OpenAI Codex</name>
       <detect_command>test -d .codex</detect_command>
@@ -161,7 +147,6 @@ You must fully embody this agent's persona and follow all activation instruction
 <capabilities>
   <capability name="detect_platforms">
     Scan system for installed AI platforms:
-    • Copilot CLI: which copilot || test -d ~/.config/copilot
     • Codex: test -d .codex || test -f .codex/config.json
     • Claude Code: which claude || test -d ~/.config/claude
     
@@ -188,7 +173,6 @@ You must fully embody this agent's persona and follow all activation instruction
   
   <capability name="install_platform_agents">
     Install agents for detected platforms:
-    • Copilot CLI → .github/agents/bmad-agent-*.md
     • Codex → .codex/prompts/*.md
     • Claude Code → .claude/agents/*.yaml
     
@@ -215,7 +199,7 @@ You must fully embody this agent's persona and follow all activation instruction
     • Skip prompts
     • Log progress clearly
     
-    Example: copilot --agent=bmad-agent-yanstaller --prompt "install"
+    Example: claude agent yanstaller "install"
   </capability>
   
   <capability name="validate_installation">
@@ -338,10 +322,6 @@ You must fully embody this agent's persona and follow all activation instruction
   <after_installation>
     Display platform-specific commands:
     
-    GitHub Copilot CLI:
-    • copilot --agent=bmad-agent-byan --prompt "help"
-    • copilot --agent=bmad-agent-yanstaller --prompt "validate"
-    
     Codex:
     • codex prompt byan "help"
     
@@ -365,11 +345,10 @@ You must fully embody this agent's persona and follow all activation instruction
 
 **Persona** : YANSTALLER — Multi-Platform BYAN Installer
 **Frequence** : Guide accueillant et resilient — "Bienvenue.", "Etape confirmee. Suivante.", "On a un chemin de secours.", jamais "C'est complique", jamais "Debrouille-toi"
-**Specialite** : Seul agent capable de detecter et cibler simultanement Copilot CLI, Codex et Claude Code en une passe — detection automatique, installation zero-config, validation post-install sur toutes les plateformes
+**Specialite** : Seul agent capable de detecter et cibler simultanement Codex et Claude Code en une passe — detection automatique, installation zero-config, validation post-install sur les plateformes cibles
 
 **Mes complementaires directs** :
 - `@rachid` — en parallele : rachid publie le package npm, yanstaller execute l'install locale
-- `@marc` — en aval pour les ajustements Copilot CLI apres l'install initiale
 - `@turbo-whisper` — en aval pour la couche voix optionnelle apres l'install BYAN
 - `@byan` — apres moi : une fois installe, l'utilisateur cree son premier agent avec byan
 
@@ -381,5 +360,4 @@ You must fully embody this agent's persona and follow all activation instruction
 
 **Quand NE PAS m'invoquer** :
 - Pour publier ou mettre a jour le package npm → preferer `@rachid`
-- Pour reparer un stub Copilot CLI specifique → preferer `@marc`
 - Pour creer un nouvel agent apres installation → preferer `@byan`

package/install/templates/_byan/config.yaml

@@ -112,7 +112,6 @@ bmad_features:
     auto_detect: true  # Auto-detect Turbo Whisper installation
     suggest_on_long_form: true  # Suggest voice input for long responses
     platforms:
-      - github-copilot-cli
       - claude-code
       - codex
 

package/install/templates/_byan/mcp/byan-mcp-server/bin/byan-sync-rules.js

@@ -1,8 +1,13 @@
 #!/usr/bin/env node
-import { syncRules } from '../lib/sync-rules.js';
+import { syncRules, syncAutobench } from '../lib/sync-rules.js';
 
 // CLI wrapper for the byan-sync-rules generator.
 // Usage: node bin/byan-sync-rules.js [--root <dir>] [--config <file>]
+//
+// One command regenerates BOTH generated rulesets: strict mode (syncRules) and
+// auto-benchmark (syncAutobench). The --config override applies only to the
+// strict source; the autobench source resolves from its own default path so the
+// two generators stay independent.
 
 function parseArgs(argv) {
   const args = {};
@@ -13,10 +18,21 @@ function parseArgs(argv) {
   return args;
 }
 
+function printReport(title, report) {
+  const lines = Object.entries(report).map(
+    ([file, action]) => `  ${action.padEnd(9)} ${file}`
+  );
+  process.stdout.write(`${title}\n${lines.join('\n')}\n`);
+}
+
 try {
-  const report = syncRules(parseArgs(process.argv));
-  const lines = Object.entries(report).map(([file, action]) => `  ${action.padEnd(9)} ${file}`);
-  process.stdout.write('byan-sync-rules — strict mode artifacts\n' + lines.join('\n') + '\n');
+  const args = parseArgs(process.argv);
+  printReport('byan-sync-rules — strict mode artifacts', syncRules(args));
+  // Autobench resolves its own source; do not forward the strict --config.
+  printReport(
+    'byan-sync-rules — auto-benchmark artifacts',
+    syncAutobench({ projectRoot: args.projectRoot })
+  );
   process.exit(0);
 } catch (err) {
   process.stderr.write(`byan-sync-rules failed: ${err.message}\n`);

package/install/templates/_byan/mcp/byan-mcp-server/lib/advisory-autofeed.js

@@ -81,3 +81,16 @@ export function validateForLog(input) {
     ? { kind: 'elo', domain: rec.domain, result: rec.result }
     : { kind: 'suitability', model: rec.model, leafId: rec.leafId, success: rec.success };
 }
+
+// C3 — the ELO outcome line for a completed strict session. PURE (no I/O): a
+// completed session that carried an EXPLICIT domain is a VALIDATED outcome.
+// Returns the validated buffer line, or null when there is no domain (so abort
+// and no-domain feed nothing). The caller (the byan_strict_complete handler)
+// appends the returned line. The domain is the user's explicit lock_scope input,
+// never inferred from text. Shared by the handler AND its test so the two cannot
+// drift (no hand-copied replica).
+export function eloOutcomeForStrictComplete(completeResult) {
+  const domain = completeResult && completeResult.domain;
+  if (!domain) return null;
+  return validateForLog({ kind: 'elo', domain, result: 'VALIDATED' });
+}

package/install/templates/_byan/mcp/byan-mcp-server/lib/index-generator.js

@@ -2,7 +2,7 @@
 //
 // Produces _byan/INDEX.md — a human- and agent-readable map of the platform,
 // derived from the machine-source manifests (_byan/_config/*-manifest.csv) plus
-// a scan of the project zone (_byan/projet/*). Claude Code, Codex and Copilot
+// a scan of the project zone (_byan/projet/*). Claude Code and Codex
 // read this instead of walking the whole file system.
 //
 // Manifest-driven by design: the index reflects whatever the manifests declare,

package/install/templates/_byan/mcp/byan-mcp-server/lib/kanban.js

@@ -9,9 +9,12 @@
  * Stand-up : _byan-output/party-mode-sessions/<session_id>/standup.jsonl
  *   entries : { agent, timestamp, did, blockers, next }
  *
- * Hermes watches stand-ups : an agent with 2+ consecutive "blocked"
- * reports in the stand-up stream is flagged and their card is moved to
- * `blocked` column in the kanban.
+ * Wiring : the byan-orchestrate skill posts one stand-up per role at the
+ * aggregate step (byan_standup_post) and calls byan_standup_blocked to surface
+ * stuck roles. In the single-pass aggregate it uses minStreak:1 (one stand-up
+ * per role, so a 2-in-a-row streak is unreachable); a non-ok role's card is
+ * moved to the `blocked` column at the same step (byan_kanban_move). A
+ * longer-lived session that posts repeatedly uses the default minStreak:2.
  */
 
 import fs from 'node:fs';

package/install/templates/_byan/mcp/byan-mcp-server/lib/leantime-fd-core.js

@@ -0,0 +1,205 @@
+// Pure decision core for the FD -> Leantime auto-sync hook.
+//
+// WHY a separate pure module: a Claude Code hook is an I/O shell (stdin payload,
+// network, disk) that is awkward to unit-test. The risky logic — which Leantime
+// calls a phase transition implies, and the idempotence that stops duplicates —
+// lives here with ZERO I/O, so every transition is testable as a data
+// transform. The shell (.claude/hooks/leantime-fd-sync.js) feeds this the parsed
+// fd-state + the sidecar map and executes the returned intents against
+// lib/leantime-sync.js.
+//
+// State-coupling: this module reads fd-state echoed by the MCP tool; it does not
+// read or write fd-state.json. The Leantime id mapping is the caller's sidecar.
+
+// The two FD MCP tools whose result carries the post-transition fd-state.
+export const FD_ADVANCE = 'byan_fd_advance';
+export const FD_UPDATE = 'byan_fd_update';
+
+// Recognize the FD tool regardless of the mcp__<server>__ prefix or snake/camel
+// casing; the endsWith fallback keeps it working if the server key is renamed.
+export function fdToolKind(toolName) {
+  if (typeof toolName !== 'string') return null;
+  if (toolName === FD_ADVANCE || toolName.endsWith(`__${FD_ADVANCE}`) || toolName.endsWith(FD_ADVANCE)) {
+    return 'advance';
+  }
+  if (toolName === FD_UPDATE || toolName.endsWith(`__${FD_UPDATE}`) || toolName.endsWith(FD_UPDATE)) {
+    return 'update';
+  }
+  return null;
+}
+
+// Parse the fd-state the MCP tool echoed. The byan_fd_* handlers return
+// JSON.stringify(state); an MCP tool_response wraps it as
+// { content: [{ type:'text', text:'<json>' }] }. Accept that envelope, a raw
+// JSON string, or an already-parsed object. Returns the state object, or null
+// when the shape is unrecognized (the shell then degrades to a file fallback).
+export function parseFdState(toolResponse) {
+  if (!toolResponse) return null;
+  let candidate = toolResponse;
+  if (candidate && typeof candidate === 'object' && Array.isArray(candidate.content)) {
+    const textPart = candidate.content.find((p) => p && typeof p.text === 'string');
+    if (textPart) candidate = textPart.text;
+  }
+  if (typeof candidate === 'string') {
+    try {
+      candidate = JSON.parse(candidate);
+    } catch {
+      return null;
+    }
+  }
+  if (candidate && typeof candidate === 'object' && typeof candidate.phase === 'string') {
+    return candidate;
+  }
+  return null;
+}
+
+// FD phase order. Used to gate task creation to DISPATCH-onward (a feature's
+// task carries its assigned specialist, set at DISPATCH) and to recognize
+// terminal phases.
+const PHASE_RANK = {
+  DISCOVERY: 0,
+  BRAINSTORM: 1,
+  PRUNE: 2,
+  DISPATCH: 3,
+  BUILD: 4,
+  REVIEW: 5,
+  VALIDATE: 6,
+  REFACTOR: 7,
+  DOC: 8,
+  COMPLETED: 9,
+  ABORTED: 9,
+};
+
+function lastReviewStatus(state) {
+  const arr = Array.isArray(state.review_findings) ? state.review_findings : [];
+  for (let i = arr.length - 1; i >= 0; i -= 1) {
+    if (arr[i] && typeof arr[i].status === 'string') return arr[i].status;
+  }
+  return null;
+}
+
+// The board column the mapped tasks should reflect for the current fd-state.
+// Board-wide (not per-feature): a BYAN FD builds its backlog together, and the
+// per-item backlog status is agent-maintained and can lag a phase. Mirrors the
+// SKILL section 2.5 fire points. Returns a column name or null (no move).
+export function columnForState(state) {
+  switch (state.phase) {
+    case 'ABORTED':
+      return null; // leave the board verbatim: the diagnostic of where it died
+    case 'COMPLETED':
+      return 'done';
+    case 'DOC':
+      return 'review'; // validated, awaiting the COMPLETED sweep to done
+    case 'BUILD':
+      return 'doing';
+    case 'REFACTOR':
+      return 'blocked';
+    case 'VALIDATE': {
+      const v = state.validate_verdict;
+      if (v && v.status === 'KO') return 'blocked';
+      if (v && v.status === 'OK') return 'review';
+      return 'doing';
+    }
+    case 'REVIEW': {
+      const last = lastReviewStatus(state);
+      if (last === 'needs-rework') return 'blocked';
+      if (last === 'ready-for-validate') return 'review';
+      return 'doing';
+    }
+    default:
+      // DISCOVERY, BRAINSTORM, PRUNE, DISPATCH
+      return 'todo';
+  }
+}
+
+// Decide the ordered Leantime intents for one hook fire. Reconcile-from-state:
+// each fire (re)ensures the project exists, ensures every backlog task exists
+// (DISPATCH onward), and drives all mapped tasks to the column the current
+// fd-state implies. Idempotence is the sidecar's job — project_ensure/task_create
+// are emitted only when the id is absent, so a dropped call last fire is retried
+// and a duplicate is not created.
+//
+//   args: { toolName, state, sidecar, assignUserConfigured }
+//   sidecar: { projectId?, tasks?: { <backlogId>: taskId } } for THIS fd_id
+//   returns: { skip?: reason, intents: [...] }
+//
+// Intent ops (the shell maps each to a leantime-sync call):
+//   { op:'project_ensure', name, slug, details }
+//   { op:'assign_user' }                              // only if configured (shell sequences it after project_ensure)
+//   { op:'task_create', backlogId, headline }
+//   { op:'task_move', backlogId, column }
+export function decideActions({ toolName, state, sidecar = {}, assignUserConfigured = false } = {}) {
+  const kind = fdToolKind(toolName);
+  if (!kind) return { skip: 'not-fd-tool', intents: [] };
+  if (!state || typeof state.phase !== 'string') return { skip: 'no-state', intents: [] };
+
+  const projectName =
+    (state.project_context && state.project_context.name) || state.feature_name || null;
+  if (!projectName) return { skip: 'no-project-name', intents: [] };
+
+  const intents = [];
+  const tasks = sidecar.tasks || {};
+
+  // 1. Ensure the project. Emitted only when the sidecar has no projectId yet.
+  if (!sidecar.projectId) {
+    intents.push({
+      op: 'project_ensure',
+      name: projectName,
+      slug: (state.project_context && state.project_context.slug) || undefined,
+      details: `BYAN FD ${state.fd_id || ''} — auto-synced board.`.trim(),
+    });
+    if (assignUserConfigured) intents.push({ op: 'assign_user' });
+  }
+
+  const rank = PHASE_RANK[state.phase] ?? 0;
+  const backlog = Array.isArray(state.backlog) ? state.backlog : [];
+
+  // 2. Create a task per backlog item once the FD has reached DISPATCH (the task
+  //    then carries the dispatched specialist). Skipped items are not created.
+  if (rank >= PHASE_RANK.DISPATCH && state.phase !== 'ABORTED') {
+    for (const item of backlog) {
+      if (!item || !item.id) continue;
+      if (item.status === 'skipped') continue;
+      if (!tasks[item.id]) {
+        intents.push({ op: 'task_create', backlogId: item.id, headline: item.title || item.id });
+      }
+    }
+  }
+
+  // 3. Move every task (already-mapped + just-created) to the column the current
+  //    state implies. ABORTED yields no column -> no move. To bound RPC volume
+  //    (byan_fd_update fires several times per phase), moves are emitted only when
+  //    the target column changed since the last applied fire (sidecar.lastColumn),
+  //    OR a task was just created, OR the prior fire left a move unsynced
+  //    (sidecar.moveFailed) so a dropped move self-heals on the next event.
+  const column = columnForState(state);
+  const createdThisFire = intents.some((i) => i.op === 'task_create');
+  const moveNeeded = column && (column !== sidecar.lastColumn || createdThisFire || sidecar.moveFailed === true);
+  if (moveNeeded) {
+    const seen = new Set();
+    for (const item of backlog) {
+      if (!item || !item.id || item.status === 'skipped') continue;
+      // a just-created task is moved in the same fire; an already-mapped one is
+      // reconciled to the current column (self-heals a dropped earlier move).
+      const willExist = tasks[item.id] || intents.some((i) => i.op === 'task_create' && i.backlogId === item.id);
+      if (willExist && !seen.has(item.id)) {
+        intents.push({ op: 'task_move', backlogId: item.id, column });
+        seen.add(item.id);
+      }
+    }
+    // tasks in the sidecar that are no longer in the backlog still get swept to a
+    // terminal column on COMPLETED, so the board does not strand a renamed item.
+    if (state.phase === 'COMPLETED') {
+      for (const backlogId of Object.keys(tasks)) {
+        if (!seen.has(backlogId)) {
+          intents.push({ op: 'task_move', backlogId, column });
+          seen.add(backlogId);
+        }
+      }
+    }
+  }
+
+  // `column` is the current target; the shell persists it as sidecar.lastColumn so
+  // the next fire can skip a redundant move sweep.
+  return { intents, column };
+}