@dzhechkov/keysarium 1.5.13 → 1.5.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/keysarium",
-  "version": "1.5.13",
+  "version": "1.5.17",
   "description": "AI Case Research Toolkit for Claude Code — full 7-phase pipeline with feature-adr, dream cycles, background workers, multi-platform support, reward learning, and Cloud.ru AI Factory mapping (--ai-factory flag)",
   "main": "src/cli.js",
   "bin": {

package/templates/.claude/skills/feature-adr/SKILL.md

@@ -355,11 +355,25 @@ Step 0 (Complexity Router) checks:
   description, code, tier, stopAfter, repo, dzBin } })`. Hybrid checkpoints: S/M autonomous; L/XL return
   after the Plan phase for your steer. See `.claude/rules/feature-adr-ultracode.md`.
 
-**Optional Codex planner (opt-in).** When Codex is installed + logged in (`codex login --device-auth`
-on a headless VPS, or `printenv OPENAI_API_KEY | codex login --with-api-key`), the pipeline can route the
-**planning step to Codex's top model**. It ALWAYS asks first — a pre-flight *"Use the top Codex model for
-planning?"* — and falls back to Claude if you decline or Codex is unavailable (never blocks). ultracode:
-pass `args.planner: 'codex'`. Plain `/feature-adr`: the same offer appears at the planning checkpoint.
+**Optional Codex routing (opt-in).** When Codex is installed + logged in (`codex login --device-auth`
+on a headless VPS, or `printenv OPENAI_API_KEY | codex login --with-api-key`), the pipeline can route work
+to Codex — always ASKING first, always with a Claude fallback (never blocks):
+
+- **Planning (Step 6)** on Codex's top model → `args.planner: 'codex'`.
+- **Code (Step 7) + tests/QE (Step 8) FALLBACK** → `args.coder: 'codex-fallback'`, `args.qeReviewer:
+  'codex-fallback'`: Claude runs first, and only if the **Claude Code limit is exhausted mid-run** (the
+  agent returns null) does the SAME task retry on Codex — so a long build never stalls on a rate limit.
+- **Model choice** → `args.codexModel` (`auto` default (Codex self-selects) · or an id your account exposes (e.g. `gpt-5.5`)).
+
+*Scenario:* an L/XL run hits the session limit during coding → with `coder: 'codex-fallback'` feature-adr
+logs *"Claude unavailable (limit?) — falling back to Codex auto"* and finishes on Codex, no restart.
+
+*Example:* `Workflow({ scriptPath: '.claude/workflows/feature-adr.js', args: { slug, description, tier:
+'M', planner: 'codex', coder: 'codex-fallback', qeReviewer: 'codex-fallback', codexModel: 'auto' } })  // 'auto' = Codex picks top; or pin e.g. 'gpt-5.5'`.
+
+Pre-flight, if Codex is `ready` (`codex-companion setup --json`), the orchestrator asks these three
+before launching; plain `/feature-adr` offers the same at the planning checkpoint. Omit the Codex knobs
+for today's all-Claude behavior. See `.claude/rules/feature-adr-ultracode.md`.
 
 ### Pattern memory loop (self-learning — runs in ALL modes)