create-byan-agent 2.41.0 → 2.44.0

package/CHANGELOG.md

@@ -9,6 +9,150 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.44.0] - 2026-07-15
+
+### Changed - Revived the Sonnet middle tier for native-workflow model routing
+
+- Native-workflow ANALYSIS leaves (score/rank/assess/design/nfr/coverage/
+  recommend/synthesize) now auto-route to the balanced tier (`model: 'sonnet'`)
+  instead of `deep` (inherit the session model). Before this, the Sonnet rung was
+  reachable only through the explicit `mech-` opt-in, so on an Opus (or high-effort)
+  session every analysis/verification/implementation leaf ran on Opus — the Sonnet
+  tier was effectively dead (ledger: recent workflows logged all-`inherit`).
+- This deliberately overrides the session model for analysis leaves; a genuinely
+  frontier analysis opts back to the session model with the `deep-` label prefix
+  (`deep-assess-architecture`), the mirror of the `mech-` opt-in. VERIFICATION and
+  IMPLEMENTATION are untouched — a wrong check or a code-write still inherits the
+  session model (no silent downgrade of the dangerous classes).
+- Propagated through the enforcement stack: `modelRoutingViolations` accepts sonnet
+  on an analysis leaf (its tier) and still blocks haiku (`analysis-below-tier`) and
+  any downgrade on a protected leaf; added a non-blocking `untiered-analysis`
+  advisory (surfaces an analysis leaf running deep, suggests `model: 'sonnet'`).
+  Files: `native-tiers.js` (tierFor + `DEEP_PREFIX` + `synthes` keyword),
+  `workflows-lint.js`, `bin/byan-lint-workflows.js`, native-workflows.md.
+- The 21 committed workflows still pass the contract; MCP 792 + jest 2606 green.
+
+## [2.43.0] - 2026-07-10
+
+### Removed - Purged the Gen1 `_bmad/` legacy layer
+
+- Removed the Gen1 `_bmad/` fallback from the layout resolver
+  (`src/byan-v2/lib/layout-resolver.js`): `resolveAgent` / `agentDirs` now resolve
+  Gen3 (`_byan/agent/<name>/`) and Gen2 (`_byan/agents/`, `_byan/<module>/agents/`)
+  only. A pre-Gen3 project on the raw `_bmad/` layout is migrated with
+  `scripts/migrate-bmad-to-byan.js` (agents land under `_byan/`, resolved by the
+  Gen2 branches). Added a regression test locking Gen1 resolution to null.
+- Deleted the frozen Gen1 content: `_bmad/` (677 files) and the dead shipped
+  template `install/templates/_bmad/` (17 files) that the installer does not copy
+  (it scaffolds `templates/_byan/`). Neither carried a live code path.
+- Removed the dead `marc` agent residues (a GitHub Copilot CLI specialist for the
+  already-removed Copilot platform, present only under `_bmad/`): the
+  `subagent-generator` model-map key, an `agent-launcher` jsdoc example, and the
+  `marc.md` entry in the migrator's agent list.
+- Migrated `_bmad` doc references to `_byan` (CLAUDE.md, QUICK-START,
+  GUIDE-UTILISATION, soul-activation, workers) and cleaned stale Gen1
+  comments / dead branches (agent-packager, bridge, cli-detector, index example).
+- Kept the migration back-compat intact: the webui legacy-install detection, the
+  `migrate-bmad-to-byan` script, `stub-sync`, and the `_bmad-output` user-data scan.
+
+### Note - Known follow-up
+
+- `install/install.sh` (a dormant legacy shell installer) still scaffolds a Gen1
+  `_bmad/` tree and promotes GitHub Copilot CLI. It ships but is not run by the
+  npx flow. It needs a dedicated rework to align with the Gen3-only, Copilot-free
+  product; deliberately left out of this purge to avoid touching an untested
+  installer path.
+
+## [2.42.1] - 2026-07-06
+
+### Changed - Excised the dead stub half of the yanstaller module
+
+- Removed six pure-stub files under `install/lib/yanstaller/` that had no caller
+  (`installer.js`, `validator.js`, `recommender.js`, `interviewer.js`,
+  `troubleshooter.js`, `wizard.js`). `installer.js` faked a successful install
+  without touching the disk; `validator.js` returned `passed: true` for its ten
+  checks without inspecting anything. The real installer is
+  `install/bin/create-byan-agent-v2.js`.
+- Dropped the half-implemented `install()`/`uninstall()` orchestrator from
+  `install/lib/yanstaller/index.js`. The live surface consumed by the CLI
+  (`update` / `rollback` / `backups` / `check`) and the web UI is untouched:
+  `update`, `rollback`, `listBackups`, plus the `detector` / `platformSelector`
+  / `updater` / `backuper` modules.
+- Removed the dead `yanstaller.install()` call from the web UI install path
+  (`install/src/webui/api.js`); it already had its own directory/config
+  fallback and had logged that call as a stub.
+- Added `install/__tests__/yanstaller/no-stub-guard.test.js`, a regression guard
+  that keeps the excised stubs from creeping back and locks the surviving public
+  surface. Net: -853 / +11 lines shipped to npm consumers.
+
+### Changed - Purged emoji from the installer CLI output (Mantra IA-23)
+
+- Removed every emoji from the 16 live installer files under `install/lib/` and
+  `install/bin/` (201 occurrences). Status glyphs became bracket tags matching
+  the existing `[DEBUG]` idiom: `[OK]` / `[INFO]` / `[WARN]` / `[ERROR]` / `[x]`;
+  decorative glyphs were dropped and the arrow `->` de-symbolized. Message text,
+  colors, and control flow are unchanged (a `git diff -w` is emoji-only).
+- Updated the two coupled tests in lockstep: `install/__tests__/utils/logger.test.js`
+  and `install/__tests__/integration/platform-integration.test.js`.
+
+### Removed - Dead Copilot-era task-tool-interface stub
+
+- Deleted `task-tool-interface.js` + `-mock.js` from both `src/byan-v2/dispatcher/`
+  and `install/src/byan-v2/dispatcher/`, plus their test. The module had no caller
+  outside its own test. Scrubbed the five stale `TaskToolInterface` doc references
+  it left behind (`task-router` JSDoc + `COMPLETION-REPORT.md`).
+
+## [2.42.0] - 2026-07-06
+
+### Fixed - Shipped Claude Code hooks no longer spam MODULE_NOT_FOUND
+- **Every hook command in the shipped `.claude/settings.json` is now
+  self-guarded.** The hooks run on every tool (empty matcher); a bare
+  `node "$CLAUDE_PROJECT_DIR"/.claude/hooks/X.js` threw `MODULE_NOT_FOUND` on
+  every tool call whenever the script was not resolvable — a non-BYAN project, an
+  empty `$CLAUDE_PROJECT_DIR`, a partial install, or version drift. Each command
+  is now `p="$CLAUDE_PROJECT_DIR/.claude/hooks/X.js"; [ -f "$p" ] || exit 0; exec
+  node "$p"`: a missing script no-ops with exit 0 (the tool proceeds), a present
+  script runs via `exec` so its exit code is preserved (a blocking PreToolUse /
+  Stop guard still blocks). Covered by
+  `install/__tests__/hook-invocation-guard.test.js` (guarded-shape on all 24
+  commands + runtime sh simulation: absent/empty -> 0, blocker -> 2, stdin
+  passthrough).
+
+### Changed - Handoff auto-import instructions
+- **Claude and Codex activation surfaces now know how to handle
+  `importe depuis claude` / `importe depuis codex` automatically.** `CLAUDE.md`
+  and BYAN skills instruct the assistant to run
+  `byan-handoff latest --from <source> --prompt` and resume from the generated
+  context without relying on native assistant memory.
+
+### Added - Portable Claude/Codex Markdown handoff
+- **BYAN can now export/import project state as a portable Markdown handoff for
+  switching between Claude Code and Codex.** The new `byan-handoff` CLI writes
+  handoffs under `_byan-output/handoffs/`, embeds a parseable
+  `json byan-handoff` block, and can print a compact resume prompt via
+  `byan-handoff latest --from <source> --prompt` or
+  `byan-handoff import <file> --prompt`.
+  A new `project-handoff` BYAN workflow documents the limit-switch protocol.
+  Covered by `install/__tests__/project-handoff.test.js`.
+
+### Changed - RTK offered on Codex-selected installs
+- **Yanstaller now offers RTK when the selected target includes Codex, not only
+  Claude Code.** Claude Code keeps the transparent `rtk init -g --auto-patch`
+  hook path. Codex installs get the verified native `rtk` binary and an explicit
+  no-transparent-hook status, matching BYAN's current Codex adapter model.
+  Covered by `install/__tests__/rtk-integration.test.js`.
+
+### Added - Codex native skills in yanstaller
+- **Codex installs now get real native skills, not just project prompt stubs.**
+  When the yanstaller target includes Codex (Codex-only or Claude+Codex), it
+  writes the BYAN MCP entry to `~/.codex/config.toml` and copies BYAN skill
+  folders into `~/.codex/skills`, creating `~/.codex` when Codex was explicitly
+  selected. The project template also ships `.codex/skills/byan/SKILL.md`, so a
+  fresh Codex install has a native skill named `byan` in addition to the
+  Claude-derived BYAN specialty skills. This closes the gap where a fresh
+  machine had `.codex/prompts/` and MCP wiring but no native `$byan` / BYAN skill
+  surface for delegation. Covered by `install/__tests__/codex-native-setup.test.js`.
+
 ### Added - Codex auto-delegation (opt-in, native)
 - **BYAN now proposes handing delegable work to Codex on your ChatGPT
   subscription (no API credit) when Claude nears its 5h limit.** A

package/install/bin/byan-handoff.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const {
+  buildHandoff,
+  latestHandoff,
+  parseMarkdown,
+  renderMarkdown,
+  renderResumePrompt,
+  writeHandoff,
+} = require('../lib/project-handoff');
+
+function usage() {
+  return [
+    'byan-handoff export [--from claude|codex] [--to codex|claude] [--task <text>] [--summary <text>] [--next <text>] [--out <file>] [--root <dir>] [--stdout]',
+    'byan-handoff import <file> [--prompt] [--json] [--root <dir>]',
+    'byan-handoff latest [--from claude|codex] [--prompt] [--json] [--root <dir>]',
+  ].join('\n');
+}
+
+function parseArgs(argv) {
+  const args = {
+    cmd: argv[2] || 'export',
+    root: process.cwd(),
+    from: null,
+    to: null,
+    task: null,
+    summary: null,
+    out: null,
+    stdout: false,
+    prompt: false,
+    json: false,
+    next: [],
+    decisions: [],
+    blockers: [],
+    commands: [],
+    notes: [],
+    file: null,
+  };
+
+  for (let i = 3; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--root') args.root = argv[++i];
+    else if (a === '--from') args.from = argv[++i];
+    else if (a === '--to') args.to = argv[++i];
+    else if (a === '--task') args.task = argv[++i];
+    else if (a === '--summary') args.summary = argv[++i];
+    else if (a === '--out') args.out = argv[++i];
+    else if (a === '--stdout') args.stdout = true;
+    else if (a === '--prompt') args.prompt = true;
+    else if (a === '--json') args.json = true;
+    else if (a === '--next') args.next.push(argv[++i]);
+    else if (a === '--decision') args.decisions.push(argv[++i]);
+    else if (a === '--blocker') args.blockers.push(argv[++i]);
+    else if (a === '--command') args.commands.push(argv[++i]);
+    else if (a === '--note') args.notes.push(argv[++i]);
+    else if (a === '-h' || a === '--help') args.help = true;
+    else if (!args.file) args.file = a;
+    else throw new Error(`Unexpected argument: ${a}`);
+  }
+  return args;
+}
+
+function readHandoffFile(file) {
+  return parseMarkdown(fs.readFileSync(file, 'utf8'));
+}
+
+function printImported(handoff, args) {
+  if (args.json) {
+    process.stdout.write(JSON.stringify(handoff, null, 2) + '\n');
+  } else if (args.prompt) {
+    process.stdout.write(renderResumePrompt(handoff) + '\n');
+  } else {
+    process.stdout.write(renderMarkdown(handoff) + '\n');
+  }
+}
+
+function main() {
+  try {
+    const args = parseArgs(process.argv);
+    if (args.help) {
+      console.log(usage());
+      return;
+    }
+
+    const root = path.resolve(args.root);
+    if (args.cmd === 'export') {
+      const handoff = buildHandoff({
+        root,
+        from: args.from,
+        to: args.to,
+        task: args.task,
+        summary: args.summary,
+        nextActions: args.next,
+        decisions: args.decisions,
+        blockers: args.blockers,
+        commands: args.commands,
+        notes: args.notes,
+      });
+      if (args.stdout) {
+        process.stdout.write(renderMarkdown(handoff) + '\n');
+        return;
+      }
+      const result = writeHandoff(root, handoff, { outPath: args.out });
+      process.stdout.write(`${result.path}\n`);
+      return;
+    }
+
+    if (args.cmd === 'import') {
+      if (!args.file) throw new Error('Missing handoff file');
+      printImported(readHandoffFile(path.resolve(root, args.file)), args);
+      return;
+    }
+
+    if (args.cmd === 'latest') {
+      const file = latestHandoff(root, { from: args.from });
+      if (!file) {
+        const suffix = args.from ? ` from ${args.from}` : '';
+        throw new Error(`No handoff${suffix} found under _byan-output/handoffs`);
+      }
+      if (!args.prompt && !args.json) {
+        process.stdout.write(`${file}\n`);
+        return;
+      }
+      printImported(readHandoffFile(file), args);
+      return;
+    }
+
+    throw new Error(`Unknown command: ${args.cmd}`);
+  } catch (err) {
+    process.stderr.write(`byan-handoff: ${err.message}\n`);
+    process.stderr.write(usage() + '\n');
+    process.exit(1);
+  }
+}
+
+main();

package/install/bin/byan-kanban.js

@@ -86,7 +86,7 @@ function renderStandups(entries) {
       const blockers = e.blockers && e.blockers.length > 0
         ? FG(COLORS.blocked, ` blockers=${e.blockers.join('|')}`)
         : '';
-      return `${e.timestamp} ${e.agent}: ${e.did || '-'}${blockers} → ${e.next || '-'}`;
+      return `${e.timestamp} ${e.agent}: ${e.did || '-'}${blockers} -> ${e.next || '-'}`;
     })
     .join('\n');
 }