create-byan-agent 2.25.0 → 2.26.0

package/install/templates/_byan/worker/launchers/README.md

@@ -19,7 +19,6 @@ Launcher workers are lightweight, single-purpose components that bridge the gap
 ```
 ┌─────────────────────────────────────────────────────────┐
 │                  USER INVOKES AGENT                     │
-│  gh copilot @bmad-agent-marc                            │
 │  claude --agent claude                                  │
 │  codex skill bmad-byan                                  │
 └─────────────┬───────────────────────────────────────────┘
@@ -54,18 +53,7 @@ Launcher workers are lightweight, single-purpose components that bridge the gap
 
 ## Workers
 
-### 1. launch-yanstaller-copilot.md
-
-**Platform:** GitHub Copilot CLI  
-**Icon:** 🤖  
-**Command:** `npx create-byan-agent`  
-**Called by:** `@bmad-agent-marc`
-
-**Purpose:** Launch yanstaller on Copilot CLI platform.
-
----
-
-### 2. launch-yanstaller-claude.md
+### 1. launch-yanstaller-claude.md
 
 **Platform:** Claude Code  
 **Icon:** 🎭  
@@ -79,7 +67,7 @@ Launcher workers are lightweight, single-purpose components that bridge the gap
 
 ---
 
-### 3. launch-yanstaller-codex.md
+### 2. launch-yanstaller-codex.md
 
 **Platform:** Codex/OpenCode  
 **Icon:** 📝  
@@ -107,7 +95,6 @@ Each worker has ONE task: Launch yanstaller command.
 ### Platform Hints
 Workers set environment variables to help yanstaller detect platform:
 ```bash
-BYAN_PLATFORM_HINT=copilot  # For Copilot CLI
 BYAN_PLATFORM_HINT=claude   # For Claude Code
 BYAN_PLATFORM_HINT=codex    # For Codex
 ```
@@ -166,7 +153,7 @@ Can be run multiple times safely.
 
 ## Separation of Concerns
 
-### Stub Agents (marc/claude/codex)
+### Stub Agents (claude/codex)
 - Detect invocation
 - Call launcher worker
 - Minimal logic
@@ -185,7 +172,6 @@ Can be run multiple times safely.
 - Platform-specific integration
 - MCP server creation (Claude)
 - Skill file creation (Codex)
-- GitHub agent installation (Copilot)
 
 ---
 
@@ -196,7 +182,6 @@ _byan/
 └── workers/
     └── launchers/
         ├── README.md (this file)
-        ├── launch-yanstaller-copilot.md
         ├── launch-yanstaller-claude.md
         └── launch-yanstaller-codex.md
 ```
@@ -207,9 +192,6 @@ _byan/
 
 ### Manual Test
 ```bash
-# Test Copilot launcher
-node -e "require('./_byan/worker/launchers/worker-launch-yanstaller-copilot').launch()"
-
 # Test Claude launcher
 node -e "require('./_byan/worker/launchers/worker-launch-yanstaller-claude').launch()"
 
@@ -219,7 +201,7 @@ node -e "require('./_byan/worker/launchers/worker-launch-yanstaller-codex').laun
 
 ### Expected Output
 ```
-🤖 Launching Yanstaller on Copilot CLI...
+🎭 Launching Yanstaller on Claude Code...
 [Yanstaller interview UI appears]
 ```
 
@@ -287,7 +269,6 @@ install/
         └── workers/
             └── launchers/
                 ├── README.md
-                ├── launch-yanstaller-copilot.md
                 ├── launch-yanstaller-claude.md
                 └── launch-yanstaller-codex.md
 ```
@@ -297,7 +278,6 @@ install/
 ## Version History
 
 - **1.0.0** (2026-02-10): Initial release
-  - Copilot launcher
   - Claude launcher
   - Codex launcher
 

package/install/templates/_byan/worker/workers.md

@@ -125,7 +125,6 @@ if (complexityScore < 30) {
 **Utilisation :** Lancer yanstaller sur chaque plateforme
 
 **Fichiers :**
-- `_byan/worker/launchers/launch-yanstaller-copilot.md`
 - `_byan/worker/launchers/launch-yanstaller-claude.md`
 - `_byan/worker/launchers/launch-yanstaller-codex.md`
 
@@ -479,7 +478,6 @@ _byan/
 └── workers/
     └── launchers/
         ├── README.md
-        ├── launch-yanstaller-copilot.md
         ├── launch-yanstaller-claude.md
         └── launch-yanstaller-codex.md
 

package/install/templates/_byan/workflow/simple/bmb/byan-benchmark/workflow.md

@@ -0,0 +1,86 @@
+---
+name: byan-benchmark
+description: 'DATA-only benchmark engine for any decision fork: options x weighted-criteria matrix + best-first reco + dissent. Markdown fallback for non-native platforms (dual-path).'
+---
+
+# byan-benchmark Workflow (markdown fallback)
+
+**Goal:** Given a decision fork (>=2 non-substitutable options + weighted
+criteria + an optional judge panel), produce a scored options-x-criteria matrix,
+a best-first recommendation, and the dissenting view - as DATA. The human gate
+and the rendered table live in the orchestrating `byan-benchmark` skill, not here.
+
+**Your Role:** You are the benchmark engine. You score; the user decides. State
+mutations (FD/strict) stay out of this workflow - that is the skill's job at the
+gate.
+
+This markdown is the dual-path FALLBACK. The native engine is
+`.claude/workflows/byan-benchmark.js`; `resolveWorkflow('byan-benchmark')`
+prefers the `.js` and falls back to this file on platforms without the native
+Workflow tool.
+
+---
+
+## ARGS CONTRACT
+
+- `question` - the fork stated as a question.
+- `options` - array of `{ name, note? }` (>=2 for a real benchmark).
+- `criteria` - array of `{ name, weight }` (>=1).
+- `judges` - optional reusable panel `[{ key, lens, weighting }]`; default a
+  single neutral judge.
+- `domain` - drives strict floors (`security`/`performance` -> L2, `compliance`
+  -> L1).
+- `scope` - `internal` (no external links, coherence-first) or `external`
+  (sourcing allowed, but a URL only if opened this turn).
+
+---
+
+## STEPS
+
+### 1. RECON - parse the fork
+
+Normalise `options` to `[{name, note?}]` and `criteria` to `[{name, weight}]`
+(default weight 1). The fork is **valid** only if there are >=2 distinct,
+non-substitutable options AND >=1 criterion. A degenerate / obvious-default fork
+is not benchmarkable - return `degenerate: true` with a reason so the skill emits
+a `BYAN-BENCH:skip` marker.
+
+### 2. SOURCE - gather evidence per option
+
+For each option, write one evidence note per criterion. Routing decides links
+before depth: `internal` stays on model-knowledge with no external links;
+`external` may cite a source, but a URL appears only if WebFetch opened it this
+turn - otherwise the claim is `unverified: true`. Honour the strict domain floor.
+
+### 3. JUDGE - score each cell
+
+Per the judge panel (default neutral), score each option on each criterion 1-10,
+grade the evidence level against the 5-level rubric (L1 95% spec -> L5 20%
+opinion), and compute `weightedTotal = sum(score * weight)`. A cell below the
+strict-domain floor is flagged `unverified: true`.
+
+### 4. RECOMMEND - rank best-first + dissent
+
+Consolidate the judges into one matrix, best-first by combined weighted total.
+Recommend the winner with a one-line best-first reco. Use `confidence: assertive`
+only when the winner leads by a wide margin and its key cells are verified;
+otherwise use `confidence: lean` (low-confidence, hedged verb). Capture the
+dissent: the runner-up a reasonable judge would defend and the criterion it wins on.
+
+---
+
+## RETURN (DATA only)
+
+```json
+{ "workflow": "byan-benchmark", "question": "...", "scope": "internal",
+  "domain": "general", "options": [...], "criteria": [...],
+  "matrix": [{ "option": "...", "cells": [{ "criterion": "...", "verdict": "...",
+               "level": "L2", "score": 8, "source": "...", "unverified": false }],
+             "total": 0 }],
+  "recommendation": { "best": "...", "line": "...", "confidence": "assertive|lean" },
+  "dissent": { "option": "...", "why": "..." },
+  "degenerate": false, "needsHumanGate": true }
+```
+
+No state mutation. No emoji. The skill renders the compact 1-table, emits the
+BYAN-BENCH marker, and records state via MCP at the human gate.

package/install/templates/docs/leantime-integration.md

@@ -0,0 +1,160 @@
+# Leantime integration (one-way FD -> board)
+
+BYAN can mirror its Feature Development (FD) lifecycle onto a self-hosted
+Leantime board. The link is one-way: the FD workflow drives the Leantime board;
+the board does not drive FD. The integration is optional and best-effort — when
+it is not configured, or Leantime is unreachable, every FD phase still advances.
+
+## What it does
+
+When configured, the FD workflow fires `byan_leantime_*` MCP tools at phase
+events:
+
+| FD phase / event | Effect on the board |
+|------------------|---------------------|
+| DISCOVERY (project confirmed) | create-or-fetch the Leantime project |
+| DISPATCH (per backlog feature) | one task per feature |
+| BUILD (feature starts) | task -> column `doing` |
+| REVIEW needs-rework / VALIDATE KO | task -> column `blocked` |
+| VALIDATE OK | task -> column `review` |
+| DOC done / feature completed | task -> column `done` |
+
+The FD lifecycle columns (`todo|doing|blocked|review|done`) are resolved to the
+project's configured Leantime status ids at call time (statuses are per-project
+ints), with a conservative fallback when the labels cannot be read.
+
+## Automatic sync (the leantime-fd-sync hook)
+
+You do not call the `byan_leantime_*` tools by hand. A Claude Code `PostToolUse`
+hook (`.claude/hooks/leantime-fd-sync.js`, registered in `.claude/settings.json`)
+fires after `byan_fd_advance` / `byan_fd_update` and applies the table above with
+no agent action:
+
+- It reads the fd-state the MCP tool echoes (it does not read or write
+  `fd-state.json`) and keeps the Leantime id map in a gitignored sidecar
+  `.byan-leantime/map.json` keyed by `fd_id`.
+- The sidecar is the idempotence ledger: a project or task is created only when
+  its id is absent, so a REFACTOR loop re-builds without a duplicate.
+- It is best-effort and bounded: it exits 0 in every path (a sync issue does not
+  block the turn), no-ops when Leantime is off, and self-heals a dropped call on
+  the next phase event (a per-call timeout plus a hook wall-clock budget).
+- It logs every attempt to `.byan-leantime/sync.jsonl` and surfaces a one-line
+  notice only on a real failure (`non_json` / `timeout` / `http_*` / `rpc_error`).
+
+The pure decision logic lives in
+`_byan/mcp/byan-mcp-server/lib/leantime-fd-core.js` (`decideActions`); the hook is
+a thin I/O shell. Removing the hook from `.claude/settings.json` falls back to the
+manual MCP tools below.
+
+### Human visibility (auto-assign)
+
+A project created through the API is owned by the API service user, so it stays
+hidden from a person's project selector until that person is related to it. Set
+`LEANTIME_ASSIGN_USER_ID` to your Leantime user id and the hook relates you to the
+created project (and sets you as the default task assignee). The underlying RPC
+(`editUserProjectRelations`) reconciles a user's whole project list, so the assign
+reads your current projects first and writes the union — fail-closed if that read
+is incomplete, to avoid unassigning your other projects.
+
+## Configuration
+
+Two environment variables drive the integration. They are distinct from
+`BYAN_API_URL` (byan_web) — Leantime is a separate backend.
+
+| Var | Role |
+|-----|------|
+| `LEANTIME_API_URL` | Base of the Leantime instance: the host that serves `/api/jsonrpc` (the backend), without a trailing `/api` — the client appends `/api/jsonrpc`. |
+| `LEANTIME_API_TOKEN` | The Leantime API key, sent as the `x-api-key` header. |
+| `LEANTIME_CLIENT_ID` | Optional. clientId for project creation (otherwise the first client returned, else 1). |
+| `LEANTIME_ASSIGN_USER_ID` | Optional. Your Leantime user id; the hook relates you to the created project (so it shows in your selector) and sets you as the default task assignee. Absent -> the project is visible only to the API service user. |
+
+Put the secret in `.claude/settings.local.json` (gitignored), out of any tracked
+file:
+
+```json
+{
+  "env": {
+    "LEANTIME_API_URL": "https://your-leantime-host",
+    "LEANTIME_API_TOKEN": "lt_xxxxxxxx"
+  }
+}
+```
+
+`.mcp.json` references these as `${LEANTIME_API_URL}` / `${LEANTIME_API_TOKEN}`
+(env expansion), so the secret stays out of version control. Reconnect the MCP
+server after editing `settings.local.json`.
+
+When the pair is absent, the `byan_leantime_*` tools report `enabled: false` and
+the FD proceeds unchanged.
+
+## Generating the Leantime API key
+
+Verified against Leantime source (3.7.x). Two credential types, both sent as the
+`x-api-key` header.
+
+### API key (service account — recommended for BYAN)
+
+1. Log in to Leantime with an Admin or Owner account.
+2. Open **Company Settings** (cogs icon). In a French UI the tab is labeled
+   **"Cle d'API"** (i18n key `tabs.apiKeys`), not "API" — a common reason the
+   option seems missing.
+3. Click **Generate API Key**, set a role + project scope, then Save.
+4. Copy the secret at once — it is shown one time, then hashed in the database.
+   The value carries an `lt_` prefix.
+
+Direct URL to the create form: `{host}/api/newApiKey`. A redirect to a 403 there
+means the account is below the role gate (`NewApiKey::run()` requires
+owner/admin); that gate is the usual reason a non-admin user does not see the
+menu.
+
+In Leantime an API key is implemented as a service user
+(`zp_user.source='api'`), so there is no separate "api keys" database table.
+
+### Personal Access Token (per user)
+
+Profile -> "Personal Access Tokens" tab. This tab is present when the Advanced
+Auth plugin is installed (self-hosted). Without it, use the API key above.
+
+There is no `.env` flag to enable the API: `/api/jsonrpc` is part of Leantime
+core; the access barrier is the role.
+
+## Tools
+
+| Tool | Role |
+|------|------|
+| `byan_leantime_ping` | Healthcheck: reports api_url, token_configured, enabled, reachable. Does not throw. |
+| `byan_leantime_project_ensure` | Create-or-fetch a project by name (idempotent), returns the id. |
+| `byan_leantime_task_create` | Create a task from a backlog item, returns the task id. |
+| `byan_leantime_task_move` | Move a task to a column (`todo\|doing\|blocked\|review\|done`). |
+| `byan_leantime_task_assign` | Set the assignee (editorId). |
+| `byan_leantime_task_get` | Read a task by id. |
+| `byan_leantime_board_get` | Read a project board grouped by column. |
+
+Every tool except `byan_leantime_ping` is gated by `requireLeantime` (returns a
+clear error when the env pair is absent rather than calling an unconfigured
+host).
+
+## Troubleshooting
+
+Each call returns `{ ok, synced, reason? }`. A non-synced result surfaces a
+reason instead of pretending the board moved:
+
+| reason | meaning + fix |
+|--------|---------------|
+| `no_base` / `no_token` | The integration is off (env not set). Configure the pair. |
+| `non_json` | `LEANTIME_API_URL` points at the Leantime UI host, which returned an HTML login page instead of JSON-RPC. Point it at the backend host that serves `/api/jsonrpc`. |
+| `timeout` / `http_<status>` / `rpc_error` | Transient or wire issue. The FD phase still advances; the move retries at the next phase event. |
+| `create_rejected` | The server returned a falsy id for a create. Inspect the returned data. |
+| `unresolved_status` | A column could not be mapped to a Leantime status id for this project. |
+
+## Security
+
+The API key lives only in `.claude/settings.local.json` (gitignored at both repo
+and global level). The tracked `.mcp.json` carries only `${...}` placeholders.
+`byan_leantime_ping` reports `token_configured` as a boolean and does not echo
+the token.
+
+## See also
+
+- Agent-facing reference (compact): `.claude/rules/byan-api.md` section 8.
+- FD wiring (fire points per phase): `.claude/skills/byan-byan/SKILL.md` section 2.5.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-byan-agent",
-  "version": "2.25.0",
-  "description": "BYAN v2.8 - Intelligent AI agent creator with ELO trust system + scientific fact-check + Hermes universal dispatcher + native Claude Code integration (hooks, skills, MCP server). Multi-platform (Copilot CLI, Claude Code, Codex). Merise Agile + TDD + 71 Mantras. ~54% LLM cost savings.",
+  "version": "2.26.0",
+  "description": "BYAN v2.8 - Intelligent AI agent creator with ELO trust system + scientific fact-check + Hermes universal dispatcher + native Claude Code integration (hooks, skills, MCP server). Multi-platform (Claude Code, Codex). Merise Agile + TDD + 71 Mantras. ~54% LLM cost savings.",
   "main": "src/index.js",
   "bin": {
     "create-byan-agent": "./install/bin/create-byan-agent-v2.js",
@@ -17,7 +17,7 @@
     "test:watch": "jest --watch",
     "test:e2e": "jest install/__tests__/post-install.e2e.test.js",
     "setup-turbo-whisper": "node install/setup-turbo-whisper.js",
-    "byan": "echo \"BYAN agent installed. Use: copilot and type /agent\"",
+    "byan": "echo \"BYAN agent installed. Open Claude Code (or Codex) in this project.\"",
     "version": "node scripts/sync-install-version.js && git add install/package.json",
     "app:dev": "npm --prefix app run dev",
     "app:build": "npm --prefix app run build",
@@ -29,7 +29,6 @@
     "ai",
     "multi-agent",
     "workflow",
-    "github-copilot",
     "agent-builder",
     "bmad",
     "merise-agile",
@@ -118,8 +117,5 @@
         "statements": 80
       }
     }
-  },
-  "optionalDependencies": {
-    "byan-copilot-router": "^1.0.1"
   }
 }

package/src/byan-v2/context/session-state.js

@@ -59,8 +59,8 @@ class SessionState {
     return this.currentState;
   }
 
-  mergeContext(copilotContext) {
-    this.context = copilotContext;
+  mergeContext(context) {
+    this.context = context;
   }
 
   transitionTo(newState) {

package/src/byan-v2/generation/mantra-validator.js

@@ -23,9 +23,9 @@ class MantraValidator {
     this.agentContent = null;
   }
 
-  // Strict-mode artifacts (the byan-strict skill, AGENTS.md block, copilot
-  // block) are validated against the strict mantra set, not the 64 persona
-  // mantras. The set is generated by byan-sync-rules from strict-mode.yaml.
+  // Strict-mode artifacts (the byan-strict skill, AGENTS.md block) are
+  // validated against the strict mantra set, not the 64 persona mantras.
+  // The set is generated by byan-sync-rules from strict-mode.yaml.
   _loadStrictMantras() {
     try {
       const p = path.join(__dirname, '../data/strict-mantras.json');

package/src/byan-v2/index.js

@@ -182,16 +182,12 @@ class ByanV2 {
         medium: 60
       },
       outputDir: './_byan-output',
-      env: customConfig.env || (process.env.GITHUB_COPILOT ? 'copilot' : 'standalone')
+      env: customConfig.env || 'standalone'
     };
 
     return { ...defaults, ...customConfig };
   }
 
-  isCopilotContext() {
-    return this.config.env === 'copilot' || process.env.GITHUB_COPILOT === 'true';
-  }
-
   async startSession() {
     this.logger.info('Starting BYAN session', {
       event: 'session_start',

package/src/byan-v2/integration/voice-integration.js

@@ -9,7 +9,7 @@ const execAsync = promisify(exec);
  * VoiceIntegration - Turbo Whisper voice input integration for BYAN v2
  *
  * Enables voice-driven agent interaction through Turbo Whisper transcription.
- * Supports GitHub Copilot CLI, Claude Code, and Codex platforms.
+ * Supports Claude Code and Codex platforms.
  *
  * @version 2.1.0
  * @module integration/voice-integration

package/src/byan-v2/orchestrator/generation-state.js

@@ -1,11 +1,11 @@
 /**
  * GenerationState - Story 4.4
- * Generates agent profile in BMAD/Copilot format
- * 
+ * Generates agent profile in BMAD format
+ *
  * Format:
  * - YAML frontmatter (name, description)
  * - XML structure (<agent>, <persona>, <menu>, <capabilities>)
- * - Compliant with .github/copilot/agents/ standard
+ * - Saved under the _byan/agent/ layout
  */
 
 const Logger = require('../observability/logger');
@@ -178,7 +178,7 @@ class GenerationState {
    */
   getDefaultSavePath() {
     const name = this.sessionState.agentProfileDraft?.name || 'agent';
-    return `.github/copilot/agents/${name}.md`;
+    return `_byan/agent/${name}/${name}.md`;
   }
 
   /**

package/src/staging/staging.js

@@ -1,16 +1,12 @@
 /**
  * BYAN staging core — extract / filter / dedup / queue / flush conversation
- * knowledge from any supported CLI (claude-code, copilot-cli, codex) to a
+ * knowledge from any supported CLI (claude-code, codex) to a
  * byan_web instance via POST /api/memory.
  *
  * Usage from a Claude Code Stop hook :
  *   const { processTurn } = require('./staging');
  *   await processTurn({ turn, cliSource: 'claude-code', config, projectRoot });
  *
- * Usage from a Copilot CLI extension.mjs :
- *   import { processTurn } from '<repo>/src/staging/staging.js';
- *   await processTurn({ turn, cliSource: 'copilot-cli', config, projectRoot });
- *
  * Contract :
  *   - processTurn() is idempotent (dedup by content hash)
  *   - never throws — errors go to the retry queue
@@ -304,7 +300,25 @@ async function postEntry({ entry, url, token, projectId }) {
     err.status = res.status;
     throw err;
   }
-  return res.json().catch(() => ({}));
+  // A 2xx is necessary but not sufficient: an authentik/SSO proxy answers an
+  // unauthenticated API call with 200 + an HTML login page. Swallowing that as
+  // success (the old res.json().catch(()=>({}))) silently drops the turn while
+  // reporting "flushed". Require the body to actually parse as JSON; otherwise
+  // treat it as a failure so it surfaces as a visible last_error in the queue.
+  const text = await res.text();
+  // An empty 2xx body (e.g. 204 No Content) is a benign success, not a wall —
+  // the SSO wall always carries an HTML body. Do not invert it into a failure.
+  if (!text || !text.trim()) return {};
+  try {
+    return JSON.parse(text);
+  } catch {
+    const ct = res.headers.get('content-type') || 'none';
+    const err = new Error(
+      `non-JSON 2xx (likely an auth/SSO wall; content-type ${ct}): ${text.slice(0, 120).replace(/\s+/g, ' ')}`
+    );
+    err.status = res.status;
+    throw err;
+  }
 }
 
 async function flush({ config, projectRoot, maxAttempts = 5 } = {}) {

package/install/bin/build-copilot-stubs.js

@@ -1,138 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Build Copilot CLI agent stubs from BYAN source files.
- *
- * Copilot CLI treats .github/agents/*.md as system instructions.
- * It does NOT dynamically load files referenced in the content.
- * This script inlines the full agent + soul + tao content into
- * each stub so Copilot CLI has everything it needs.
- *
- * Usage: node build-copilot-stubs.js [--agent byan] [--all]
- */
-
-const fs = require('fs');
-const path = require('path');
-const layoutResolver = require('../../src/byan-v2/lib/layout-resolver');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const AGENTS_DIR = path.join(ROOT, '.github', 'agents');
-const BYAN_DIR = path.join(ROOT, '_byan');
-
-function readFile(filePath) {
-  try {
-    return fs.readFileSync(filePath, 'utf-8');
-  } catch {
-    return null;
-  }
-}
-
-function stripFrontmatter(content) {
-  return content.replace(/^---\s*\n[\s\S]*?\n---\s*\n?/, '');
-}
-
-function buildByanStub() {
-  // Layout resolver: Gen3 _byan/agent/byan/ first, Gen2 fallback.
-  const agentHit = layoutResolver.resolveAgent('byan', { projectRoot: ROOT });
-  const agentContent = agentHit ? readFile(agentHit.path) : null;
-  if (!agentContent) {
-    console.error('Cannot find the byan agent file (looked in Gen3 _byan/agent/byan/ and Gen2 layouts)');
-    process.exit(1);
-  }
-
-  const soulHit = layoutResolver.resolveSoul('soul', { projectRoot: ROOT });
-  const taoHit = layoutResolver.resolveSoul('tao', { projectRoot: ROOT });
-  const soulContent = soulHit ? readFile(soulHit.path) : null;
-  const taoContent = taoHit ? readFile(taoHit.path) : null;
-  const soulActivation = readFile(path.join(BYAN_DIR, 'core', 'activation', 'soul-activation.md'));
-
-  const agentBody = stripFrontmatter(agentContent);
-  const soulBody = soulContent ? stripFrontmatter(soulContent) : '';
-  const taoBody = taoContent ? stripFrontmatter(taoContent) : '';
-  const activationBody = soulActivation ? stripFrontmatter(soulActivation) : '';
-
-  const stub = `---
-name: 'byan'
-description: 'BYAN - Builder of YAN - Agent Creator Specialist'
----
-
-${agentBody}
-
-<!-- ============================================================ -->
-<!-- INLINED: Soul System (soul.md + tao.md + soul-activation.md) -->
-<!-- ============================================================ -->
-
-<soul-system>
-
-<!-- soul.md -->
-${soulBody}
-
-<!-- tao.md -->
-${taoBody}
-
-<!-- soul-activation.md -->
-${activationBody}
-
-</soul-system>
-`;
-
-  const outPath = path.join(AGENTS_DIR, 'bmad-agent-byan.md');
-  fs.writeFileSync(outPath, stub, 'utf-8');
-
-  const size = Buffer.byteLength(stub, 'utf-8');
-  console.log(`Built: ${outPath} (${(size / 1024).toFixed(1)} KB)`);
-  return outPath;
-}
-
-function buildModuleAgentStub(agentName, moduleName) {
-  // Resolve the agent across layouts (Gen3 _byan/agent/<name>/, Gen2 flat +
-  // per-module); fall back to the explicit module path passed on the CLI.
-  const agentHit = layoutResolver.resolveAgent(agentName, { projectRoot: ROOT });
-  const agentPath = agentHit ? agentHit.path : path.join(BYAN_DIR, moduleName, 'agents', `${agentName}.md`);
-  const agentContent = readFile(agentPath);
-  if (!agentContent) {
-    console.error(`Cannot read agent ${agentName} (looked via resolver and ${path.relative(ROOT, agentPath)})`);
-    return null;
-  }
-
-  const agentBody = stripFrontmatter(agentContent);
-
-  // Soul sibling lives next to the resolved agent file.
-  const soulPath = path.join(path.dirname(agentPath), `${agentName}-soul.md`);
-  const soulContent = readFile(soulPath);
-  const soulSection = soulContent ? `\n<!-- soul: ${agentName}-soul.md -->\n${stripFrontmatter(soulContent)}\n` : '';
-
-  const stub = `---
-name: '${agentName}'
-description: '${agentName} agent'
----
-
-${agentBody}
-${soulSection}
-`;
-
-  const outPath = path.join(AGENTS_DIR, `bmad-agent-${agentName}.md`);
-  fs.writeFileSync(outPath, stub, 'utf-8');
-
-  const size = Buffer.byteLength(stub, 'utf-8');
-  console.log(`Built: ${outPath} (${(size / 1024).toFixed(1)} KB)`);
-  return outPath;
-}
-
-// --- CLI ---
-const args = process.argv.slice(2);
-const agentArg = args.indexOf('--agent') >= 0 ? args[args.indexOf('--agent') + 1] : null;
-const buildAll = args.includes('--all');
-
-if (agentArg === 'byan' || buildAll || args.length === 0) {
-  buildByanStub();
-}
-
-if (agentArg && agentArg !== 'byan') {
-  const mod = args.indexOf('--module') >= 0 ? args[args.indexOf('--module') + 1] : 'bmm';
-  buildModuleAgentStub(agentArg, mod);
-}
-
-if (buildAll || args.length === 0) {
-  console.log('\nDone. Run this after editing _byan/agents/byan.md, soul.md, or tao.md.');
-}