@sublang/playbook 0.4.2 → 0.6.0

package/reference/sdlc/code.playbook/playbook-code.config.template.yaml

@@ -1,29 +1,53 @@
 # SPDX-License-Identifier: Apache-2.0
 # SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
 
-# Seed template for the user-level playbook-code config.
+# Seed template for the user-level playbook-code CODE overlay.
 # First run copies this file to:
 #   ${XDG_CONFIG_HOME:-$HOME/.config}/playbook/playbook-code.config.yaml
 #
-# Safe tuning points:
-# - Change captain.adapter / captain.model / captain.reasoningEffort to
-#   pick the judge/Captain agent and its reasoning tier.
-# - Change each player's adapter, model, and reasoningEffort to pick
-#   the Coder and Reviewer agents.
+# This is a CODE *overlay*, not a full tmux-play config: playbook-code
+# composes the launched tmux-play config from it at startup (PBCODE-16).
+# The composer injects captain.from (the Playbook Captain shell adapter)
+# and the coder / reviewer player ids, and can inherit theme plus
+# captain-judge defaults from an existing tmux-play config — so you only
+# tune the fields below.
 #
-# PBRT-4 host-configuration invariants:
-# - captain.from must keep pointing at the CODE tmux-play adapter module.
-# - players[].id must remain exactly "coder" and "reviewer"; the runtime routes
-#   to those baked ids and does not remap them. The adapter derives the
-#   per-run player identity strings (substituted into <coder-llm> /
-#   <reviewer-llm> in player prompts) from each entry's model when pinned
-#   and falls back to its adapter when no model is set, so the Committer's
-#   commit-message trailers can name the concrete model.
+# Safe tuning points:
+# - captain.adapter / model / reasoningEffort pick the judge/Captain
+#   agent and its reasoning tier.
+# - players.coder and players.reviewer pick the Coder and Reviewer
+#   agents; set each role's adapter (required) and optional model /
+#   reasoningEffort / permissions. Each role's model when pinned, else
+#   its adapter, doubles as the identity string the adapter substitutes
+#   into <coder-llm> / <reviewer-llm> in player prompts (PBRT-4), so pin
+#   a model if you want the Committer's commit-message trailers to name
+#   the concrete model.
+# - Codex roles that run git under mode: auto need .git in
+#   permissions.writablePaths so git metadata writes stay profile-scoped
+#   instead of requiring bypass permissions.
+# - players.committer optionally aliases the Committer to a role
+#   (coder or reviewer); that role's pane runs the commit turn. The
+#   seeded value is reviewer; omit it to fall back to the coder.
+# - layout sizes the tmux window (layout.window: columns × rows) and
+#   sets the relative column widths (layout.columnWeights) for the
+#   Boss/Captain, Coder, and Reviewer columns.
+# - notifications configures tmux-play's host notifications. Supported
+#   events are player_finished, turn_finished, and turn_aborted; each
+#   event accepts off, bell, or desktop. The seeded defaults match
+#   cligent's generated home config, with omitted turn_aborted resolving
+#   to off.
+
+layout:
+  window:
+    columns: 174
+    rows: 49
+  columnWeights: [4, 6, 6]
+
+notifications:
+  player_finished: bell
+  turn_finished: desktop
 
 captain:
-  # PBRT-4 invariant: keep this adapter module path unchanged.
-  from: "@sublang/playbook/code/tmux-play"
-  # Tunable: the Captain/Judge adapter, model, and reasoning effort.
   adapter: claude
   model: claude-sonnet-4-6
   reasoningEffort: high
@@ -31,17 +55,18 @@ captain:
     mode: auto
 
 players:
-  # PBRT-4 invariant: keep id: coder. Tune adapter/model if desired.
-  - id: coder
-    adapter: claude
-    model: claude-opus-4-7
+  coder:
+    adapter: codex
+    model: gpt-5.5
     reasoningEffort: xhigh
     permissions:
       mode: auto
-  # PBRT-4 invariant: keep id: reviewer. Tune adapter/model if desired.
-  - id: reviewer
-    adapter: codex
-    model: gpt-5.5
+      writablePaths:
+        - .git
+  reviewer:
+    adapter: claude
+    model: claude-opus-4-8
     reasoningEffort: xhigh
     permissions:
       mode: auto
+  committer: reviewer

package/reference/sdlc/code.playbook/tmux-play.config.yaml

@@ -1,18 +1,23 @@
 # SPDX-License-Identifier: Apache-2.0
 # SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
 
-# Example tmux-play config for the CODE playbook — DR-004 §11.
+# Example tmux-play config for the CODE playbook through the
+# Playbook Captain shell — DR-008 §6.
 # Run with:
 #   tmux-play --config tmux-play.config.yaml
 
+notifications:
+  player_finished: bell
+  turn_finished: desktop
+
 captain:
-  # Dev form: sibling-path import of the compiled adapter. After
-  # @sublang/playbook is published, swap this for the package
-  # specifier — e.g.
-  #   from: "@sublang/playbook/code/tmux-play"
-  # (final form confirmed at publish time per DR-004 §11). Players,
-  # options, and the rest of the config are unchanged.
-  from: ./code.tmux-play.js
+  # Dev form: sibling-path import of the compiled shell adapter. After
+  # @sublang/playbook is published, swap this for:
+  #   from: "@sublang/playbook/playbook-captain"
+  # Existing explicit configs that still import ./code.tmux-play.js or
+  # @sublang/playbook/code/tmux-play continue through a compatibility
+  # shim that delegates to the same shell with CODE registered.
+  from: ./playbook-captain.js
   adapter: claude
   model: claude-sonnet-4-6
   reasoningEffort: high

package/reference/sdlc/code.playbook/tmux-play.production.config.yaml

@@ -2,12 +2,16 @@
 # SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
 
 # Production tmux-play config for the published CODE playbook package.
-# This intentionally imports the adapter through the package export, not
-# a local repo path. The runtime still expects the host app to provide the
-# @sublang/cligent peer dependency.
+# This intentionally imports the Playbook Captain shell through the
+# package export, not a local repo path. The runtime still expects the
+# host app to provide the @sublang/cligent peer dependency.
+
+notifications:
+  player_finished: bell
+  turn_finished: desktop
 
 captain:
-  from: "@sublang/playbook/code/tmux-play"
+  from: "@sublang/playbook/playbook-captain"
   adapter: claude
   model: claude-sonnet-4-6
   reasoningEffort: high