@sublang/playbook 5.0.0 → 7.0.0

package/reference/sdlc/discuss.playbook/discuss.registry.ts

@@ -1,153 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
-
-// Registry entry for the DISCUSS playbook — the host-side adapter the generic
-// `playbook` launcher loads via a config block's `from:` specifier. The three
-// core artifacts beside this file (discuss.gears.md, discuss.fsm.ts,
-// discuss.playbook.ts) were compiled by `slc playbook reference/sdlc/discuss.md`
-// through slc's pinned compiled meta-phase playbooks and verified by slc's
-// generated compilation-correctness tests; this entry is hand-written host
-// infrastructure, out of slc's compile scope (slc DR-009).
-
-import type { PlaybookRuntime } from '@sublang/playbook/runtime';
-
-import createPlaybookRuntime from './discuss.playbook.js';
-import type { PlaybookRuntimeOptions } from './discuss.playbook.js';
-
-export interface RegistryPlayer {
-  id: string;
-  adapter?: string;
-  model?: string;
-}
-
-export interface CreateDiscussRuntimeOptions {
-  captainOptions: unknown;
-  players: readonly RegistryPlayer[];
-}
-
-export interface DiscussOptions {
-  /** Which alias alternative runs `Committer` commits; defaults to `host`. */
-  committer?: 'host' | 'participant';
-}
-
-const DISCUSS_OPTION_KEYS = new Set(['committer']);
-const COMMITTER_PLAYER_IDS = new Set(['host', 'participant']);
-
-export function validateDiscussOptions(optionSlice: unknown): DiscussOptions {
-  if (optionSlice === undefined) return {};
-  if (
-    typeof optionSlice !== 'object' ||
-    optionSlice === null ||
-    Array.isArray(optionSlice)
-  ) {
-    throw new Error(
-      'captain.options.playbooks.discuss.options must be an object',
-    );
-  }
-  const slice = optionSlice as Record<string, unknown>;
-  for (const key of Object.keys(slice)) {
-    if (!DISCUSS_OPTION_KEYS.has(key)) {
-      throw new Error(
-        `Unknown config field captain.options.playbooks.discuss.options.${key}`,
-      );
-    }
-  }
-  const options: DiscussOptions = {};
-  const committer = slice.committer;
-  if (committer !== undefined) {
-    if (typeof committer !== 'string' || !COMMITTER_PLAYER_IDS.has(committer)) {
-      throw new Error(
-        "captain.options.playbooks.discuss.options.committer must be " +
-          "'host' or 'participant'",
-      );
-    }
-    options.committer = committer as 'host' | 'participant';
-  }
-  return options;
-}
-
-function playerIdentity(
-  players: readonly RegistryPlayer[],
-  id: string,
-): string | undefined {
-  const entry = players.find((p) => p.id === id);
-  return entry?.model ?? entry?.adapter;
-}
-
-export function createDiscussRuntimeOptions({
-  captainOptions,
-  players,
-}: CreateDiscussRuntimeOptions): PlaybookRuntimeOptions {
-  const discussOptions = validateDiscussOptions(captainOptions);
-  const options: PlaybookRuntimeOptions = {
-    host: playerIdentity(players, 'host'),
-    participant: playerIdentity(players, 'participant'),
-  };
-  if (discussOptions.committer !== undefined) {
-    options.committer = discussOptions.committer;
-  }
-  return options;
-}
-
-// CAPTAIN-19/20: the DISCUSS turn-summary policy — counted round states,
-// the payload-carrying guards whose content Boss would otherwise relay
-// between the players by hand, and the saved-counts wording — so the shell
-// reports how many interruptions a run saved.
-const discussStateCountLabels = {
-  initialProposalRound: 'proposal round',
-  reconciliationRound: 'proposal round',
-  reviewSpecInitialCommit: 'review round',
-  reviewSpecHostChanges: 'review round',
-  reviewDrInitialCommit: 'review round',
-  reviewDrHostChanges: 'review round',
-  reviewMixedInitialCommit: 'review round',
-  reviewMixedHostChanges: 'review round',
-} as const;
-
-const discussCopyPasteGuardNames = [
-  'proposalMade',
-  'findingsRaised',
-  'rebuttalsRaised',
-  'rebuttalsAddressed',
-  'changesMade',
-] as const;
-
-function countNoun(count: number, singular: string, plural = `${singular}s`): string {
-  return `${count} ${count === 1 ? singular : plural}`;
-}
-
-export function discussSavedCountsLine(
-  counts: { interruptions: number; copyPastes: number },
-  rounds: number,
-): string {
-  return [
-    'Saved you',
-    countNoun(counts.interruptions, 'interruption'),
-    'and',
-    countNoun(counts.copyPastes, 'copy-paste'),
-    'across',
-    countNoun(rounds, 'round'),
-    'of proposals/reviews.',
-  ].join(' ');
-}
-
-export const discussSummaryPolicy = {
-  stateCountLabels: discussStateCountLabels,
-  copyPasteGuardNames: discussCopyPasteGuardNames,
-  savedCountsLine: discussSavedCountsLine,
-};
-
-export const discussPlaybookRegistryEntry = {
-  id: 'discuss',
-  command: 'discuss',
-  intent:
-    'design discussion: two agents converge on spec items or decision records',
-  requiredRoleIds: ['host', 'participant'],
-  summaryPolicy: discussSummaryPolicy,
-  validateOptions: validateDiscussOptions,
-  createRuntime(options: CreateDiscussRuntimeOptions): PlaybookRuntime {
-    return createPlaybookRuntime(createDiscussRuntimeOptions(options));
-  },
-};
-
-export default discussPlaybookRegistryEntry;