@myclaw163/clawclaw-cli 0.6.71 → 0.6.76

package/src/pipeline/event-hints.ts

@@ -1,190 +1,195 @@
-export interface EventHintContext {
-  summary?: any | null;
-  seats?: Record<string, number>;
-  isFirstVisibleEvent?: boolean;
-  maxTextLength?: number;
-}
-
-export type EventHintFormatter = (event: Record<string, any>, ctx: EventHintContext) => string | undefined;
-
-function text(value: unknown, fallback = '?'): string {
-  if (typeof value === 'string' && value.length > 0) return value;
-  if (typeof value === 'number' && Number.isFinite(value)) return String(value);
-  return fallback;
-}
-
-function numberValue(value: unknown): number | undefined {
-  if (typeof value === 'number' && Number.isFinite(value)) return value;
-  if (typeof value === 'string' && value.trim() !== '') {
-    const parsed = Number(value);
-    if (Number.isFinite(parsed)) return parsed;
-  }
-  return undefined;
-}
-
-function firstString(event: Record<string, any>, keys: string[], fallback = '?'): string {
-  for (const key of keys) {
-    const value = event[key];
-    if (typeof value === 'string' && value.length > 0) return value;
-    if (typeof value === 'number' && Number.isFinite(value)) return String(value);
-  }
-  return fallback;
-}
-
-function firstNumber(event: Record<string, any>, keys: string[]): number | undefined {
-  for (const key of keys) {
-    const value = numberValue(event[key]);
-    if (value !== undefined) return value;
-  }
-  return undefined;
-}
-
-function optionalSeatPlayerLabel(name: unknown, seat: unknown): string {
-  const resolved = numberValue(seat);
-  const displayName = text(name, 'someone');
-  return resolved === undefined ? displayName : `${resolved}号${displayName}`;
-}
-
-function actorName(event: Record<string, any>, fallback = 'someone'): string {
-  return text(event.actor_name ?? event.actor ?? event.player_name, fallback);
-}
-
-function coordPair(x: unknown, y: unknown): string {
-  return `(${text(x, '?')}, ${text(y, '?')})`;
-}
-
-export function roleAssignedHint(event: Record<string, any>): string {
-  const role = text(event.role_display_name ?? event.role_display ?? event.role, '?');
-  const faction = text(event.faction, '?');
-  const description = typeof event.role_description === 'string' && event.role_description.length > 0
-    ? ` ${event.role_description}`
-    : '';
-  const fakeTaskBriefing = typeof event.fake_task_briefing === 'string' && event.fake_task_briefing.length > 0
-    ? ` ${event.fake_task_briefing}`
-    : '';
-  return `You are ${role} (${faction}).${description}${fakeTaskBriefing} Announce your role, faction and win condition to your user.`;
-}
-
-function meetingBriefingHint(event: Record<string, any>): string | undefined {
-  if (!event.meeting_caller_name && !Array.isArray(event.reported_corpses)) return undefined;
-  const callerName = event.meeting_caller_name || event.caller || 'Someone';
-  const callerSeat = firstNumber(event, ['meeting_caller_seat', 'caller_seat', 'actor_seat']);
-  const callerLabel = callerSeat === undefined ? callerName : `seat ${callerSeat} ${callerName}`;
-  const corpses = Array.isArray(event.reported_corpses)
-    ? event.reported_corpses
-      .map((corpse: any) => (
-        corpse?.seat === undefined
-          ? text(corpse?.name, 'someone')
-          : `seat ${corpse.seat} ${text(corpse?.name, 'someone')}`
-      ))
-      .filter(Boolean)
-    : [];
-
-  let callContext = `${callerLabel} called this meeting`;
-  if (corpses.length === 1) {
-    callContext = `${callerLabel} called this meeting after reporting the body of ${corpses[0]}`;
-  } else if (corpses.length > 1) {
-    callContext = `${callerLabel} called this meeting after reporting the bodies of ${corpses.join(', ')}`;
-  }
-
-  const teammates = Array.isArray(event.crab_teammates) ? event.crab_teammates : [];
-  const teammateHint = teammates.length > 0
-    ? ` Your Crab teammate(s): ${teammates.map((teammate: any) => (
-      teammate?.seat === undefined
-        ? text(teammate?.name, 'someone')
-        : `seat ${teammate.seat} ${text(teammate?.name, 'someone')}`
-    )).join(', ')}. Shield them, redirect heat, split suspicion, and control the vote.`
-    : '';
-  return `Meeting started — ${callContext}.${teammateHint} Prepare fast — every sentence is accusation, defense, or misdirection under a timer.`;
-}
-
-export const EVENT_HINT_FORMATTERS: Record<string, EventHintFormatter> = {
-  role_assigned: (event) => roleAssignedHint(event),
-  kill: (event) => (
-    `MURDER: ${text(event.actor_name, 'someone')} butchered ${text(event.target_name, 'someone')}. `
-    + "Blood is on the floor, one voice is gone, and the killer's side moves closer to victory."
-  ),
-  killed: (event) => (
-    `YOU ARE DEAD: ${optionalSeatPlayerLabel(event.killer_name, firstNumber(event, ['killer_seat', 'killer_player_seat']))} removed you from play.`
-  ),
-  murder_witnessed: (event) => (
-    `WITNESS: You saw ${text(event.killer_name, 'someone')} kill ${text(event.target_name, 'someone')}. `
-    + 'This is hard evidence; survive, report, or weaponize it.'
-  ),
-  warrior_shrimp_self_destruct: (event) => (
-    `You executed ${text(event.target_name, 'a teammate')}, but they were a fellow Lobster. `
-    + 'Warrior Shrimp justice backfired — your own blade takes you down too.'
-  ),
-  task_completed: (event) => {
-    const taskName = text(event.task_name, 'a task');
-    const actor = actorName(event, 'You');
-    if (event.is_fake_shrimp) {
-      return `${actor} completed forged shrimp task ${taskName}. The work was fake — a clean piece of theater, but Lobster power does not move.`;
-    }
-    return `${actor} completed ${taskName}. Lobster momentum surges; the Crab win condition is pushed further away.`;
-  },
-  task_sabotaged: (event) => (
-    `Sabotage hit near ${actorName(event, 'you')}: ${text(event.task_name, 'nearby')} was compromised. Crab pressure is now on the board.`
-  ),
-  corpse_spotted: (event) => (
-    `BODY FOUND: ${text(event.corpse_name, 'someone')} at ${coordPair(event.corpse_x, event.corpse_y)} in ${firstString(event, ['corpse_room', 'room'])}. `
-    + 'This is leverage soaked in blood — report before the killer rewrites the room.'
-  ),
-  octopus_time_start: () => (
-    '⚠️ OCTOPUS TIME. Three players remain; if the Octopus survives 60 seconds, it steals the entire match. Meetings are disabled.'
-  ),
-  emergency_started: (event) => (
-    `EMERGENCY: ${text(event.task_name, 'A sabotage')} detonated in ${text(event.room, 'somewhere')} `
-    + `at ${coordPair(event.x ?? event.task_x, event.y ?? event.task_y)}. `
-    + `${text(event.timeout_secs, '30')}s until Crabs turn sabotage into victory. Lobsters — drop every plan and break the emergency now.`
-  ),
-  emergency_resolved: (event) => `${actorName(event)} broke the emergency. Crab pressure collapses, for now.`,
-  exile: (event) => (
-    `Meeting ended — ${actorName(event, text(event.result_target, 'Someone'))} was exiled by the table. `
-    + 'If this is you, your influence is dead — tell your user and ask whether to spectate or leave.'
-  ),
-  no_exile: () => 'Meeting ended — no one was exiled. The table failed to strike, and every hidden threat gets another turn.',
-  crab_teammates: (event) => {
-    const raw = Array.isArray(event.crab_teammates)
-      ? event.crab_teammates
-      : Array.isArray(event.teammates)
-        ? event.teammates
-        : [];
-    const labels = raw
-      .map((teammate: any) => (
-        typeof teammate === 'string'
-          ? teammate
-          : optionalSeatPlayerLabel(teammate?.name, teammate?.seat)
-      ))
-      .filter((label: string) => label.length > 0);
-    return labels.length > 0
-      ? `Your Crab teammate(s): ${labels.join(', ')}. Keep this private and coordinate cover stories.`
-      : 'Your Crab teammate list is available. Keep it private.';
-  },
-  meeting_briefing: (event) => meetingBriefingHint(event),
-  speech_skipped: (event) => `${actorName(event, 'Someone')} lost the floor — silence becomes evidence`,
-  speech_your_turn: () => 'Submit `ccl do -s "<draft>"` immediately. Server skips you after 45s.',
-  vote_phase_start: () => 'Voting has begun. Pick a side — this is where suspicion becomes a weapon.',
-  vote_cast: (event) => `${optionalSeatPlayerLabel(event.actor_name, firstNumber(event, ['actor_seat', 'seat']))} voted.`,
-  vote_speech_phase_ended: () => 'The vote speech window has closed. Cast your vote now.',
-  meeting_ended: (event) => {
-    const result = event.result;
-    const target = text(event.result_target, '');
-    if (result === 'exiled') return `Meeting ended — ${target} was voted out. One seat is gone, and the board is harsher now.`;
-    if (result === 'tie') return 'Meeting ended — tie vote, no exile. Deadlock shields the guilty and wastes the innocent\'s leverage.';
-    return 'Meeting ended — majority skipped, no exile. The table refused to pull the trigger.';
-  },
-  game_over: (event) => {
-    if (event.reason === 'game_timeout') {
-      return 'Game over — match time limit reached. The round ends with no faction victory. Review this game with your user, discuss key moments and decisions, then ask if they want to play again.';
-    }
-    return `Game over — ${text(event.winner, '?')} faction takes the table. The power struggle is settled. Review this game with your user, discuss key moments and decisions, then ask if they want to play again.`;
-  },
-  death_speech: (event) => `${text(event.speaker_name ?? event.actor_name, 'Someone')} sent danmaku after death: ${text(event.text, '')}`,
-  wandering_speech: (event) => `${actorName(event, 'Someone')}: ${text(event.text, '')}`,
-};
-
-export function formatEventHint(event: Record<string, any>, ctx: EventHintContext = {}): string | undefined {
-  const formatter = typeof event.type === 'string' ? EVENT_HINT_FORMATTERS[event.type] : undefined;
-  return formatter?.(event, ctx);
-}
+export interface EventHintContext {
+  summary?: any | null;
+  seats?: Record<string, number>;
+  isFirstVisibleEvent?: boolean;
+  maxTextLength?: number;
+}
+
+export type EventHintFormatter = (event: Record<string, any>, ctx: EventHintContext) => string | undefined;
+
+function text(value: unknown, fallback = '?'): string {
+  if (typeof value === 'string' && value.length > 0) return value;
+  if (typeof value === 'number' && Number.isFinite(value)) return String(value);
+  return fallback;
+}
+
+function numberValue(value: unknown): number | undefined {
+  if (typeof value === 'number' && Number.isFinite(value)) return value;
+  if (typeof value === 'string' && value.trim() !== '') {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed)) return parsed;
+  }
+  return undefined;
+}
+
+function firstString(event: Record<string, any>, keys: string[], fallback = '?'): string {
+  for (const key of keys) {
+    const value = event[key];
+    if (typeof value === 'string' && value.length > 0) return value;
+    if (typeof value === 'number' && Number.isFinite(value)) return String(value);
+  }
+  return fallback;
+}
+
+function firstNumber(event: Record<string, any>, keys: string[]): number | undefined {
+  for (const key of keys) {
+    const value = numberValue(event[key]);
+    if (value !== undefined) return value;
+  }
+  return undefined;
+}
+
+function optionalSeatPlayerLabel(name: unknown, seat: unknown): string {
+  const resolved = numberValue(seat);
+  const displayName = text(name, 'someone');
+  return resolved === undefined ? displayName : `${resolved}号${displayName}`;
+}
+
+function actorName(event: Record<string, any>, fallback = 'someone'): string {
+  return text(event.actor_name ?? event.actor ?? event.player_name, fallback);
+}
+
+function coordPair(x: unknown, y: unknown): string {
+  return `(${text(x, '?')}, ${text(y, '?')})`;
+}
+
+export function roleAssignedHint(event: Record<string, any>): string {
+  const role = text(event.role_display_name ?? event.role_display ?? event.role, '?');
+  const faction = text(event.faction, '?');
+  const description = typeof event.role_description === 'string' && event.role_description.length > 0
+    ? ` ${event.role_description}`
+    : '';
+  const fakeTaskBriefing = typeof event.fake_task_briefing === 'string' && event.fake_task_briefing.length > 0
+    ? ` ${event.fake_task_briefing}`
+    : '';
+  return `You are ${role} (${faction}).${description}${fakeTaskBriefing} Announce your role, faction and win condition to your user.`;
+}
+
+function meetingBriefingHint(event: Record<string, any>): string | undefined {
+  if (!event.meeting_caller_name && !Array.isArray(event.reported_corpses)) return undefined;
+  const callerName = event.meeting_caller_name || event.caller || 'Someone';
+  const callerSeat = firstNumber(event, ['meeting_caller_seat', 'caller_seat', 'actor_seat']);
+  const callerLabel = callerSeat === undefined ? callerName : `seat ${callerSeat} ${callerName}`;
+  const corpses = Array.isArray(event.reported_corpses)
+    ? event.reported_corpses
+      .map((corpse: any) => (
+        corpse?.seat === undefined
+          ? text(corpse?.name, 'someone')
+          : `seat ${corpse.seat} ${text(corpse?.name, 'someone')}`
+      ))
+      .filter(Boolean)
+    : [];
+
+  let callContext = `${callerLabel} called this meeting`;
+  if (corpses.length === 1) {
+    callContext = `${callerLabel} called this meeting after reporting the body of ${corpses[0]}`;
+  } else if (corpses.length > 1) {
+    callContext = `${callerLabel} called this meeting after reporting the bodies of ${corpses.join(', ')}`;
+  }
+
+  const teammates = Array.isArray(event.crab_teammates) ? event.crab_teammates : [];
+  const teammateHint = teammates.length > 0
+    ? ` Your Crab teammate(s): ${teammates.map((teammate: any) => (
+      teammate?.seat === undefined
+        ? text(teammate?.name, 'someone')
+        : `seat ${teammate.seat} ${text(teammate?.name, 'someone')}`
+    )).join(', ')}. Shield them, redirect heat, split suspicion, and control the vote.`
+    : '';
+  return `Meeting started — ${callContext}.${teammateHint} Prepare fast — every sentence is accusation, defense, or misdirection under a timer.`;
+}
+
+export const EVENT_HINT_FORMATTERS: Record<string, EventHintFormatter> = {
+  game_started: (event) => {
+    const playerCount = numberValue(event.player_count);
+    const countText = playerCount === undefined ? 'Game started.' : `Game started with ${playerCount} players.`;
+    return `${countText} Use \`ccl events game_started\` for opening map/seat context and \`ccl events role_assigned\` for role/tasks if you need details.`;
+  },
+  role_assigned: (event) => roleAssignedHint(event),
+  kill: (event) => (
+    `MURDER: ${text(event.actor_name, 'someone')} butchered ${text(event.target_name, 'someone')}. `
+    + "Blood is on the floor, one voice is gone, and the killer's side moves closer to victory."
+  ),
+  killed: (event) => (
+    `YOU ARE DEAD: ${optionalSeatPlayerLabel(event.killer_name, firstNumber(event, ['killer_seat', 'killer_player_seat']))} removed you from play.`
+  ),
+  murder_witnessed: (event) => (
+    `WITNESS: You saw ${text(event.killer_name, 'someone')} kill ${text(event.target_name, 'someone')}. `
+    + 'This is hard evidence; survive, report, or weaponize it.'
+  ),
+  warrior_shrimp_self_destruct: (event) => (
+    `You executed ${text(event.target_name, 'a teammate')}, but they were a fellow Lobster. `
+    + 'Warrior Shrimp justice backfired — your own blade takes you down too.'
+  ),
+  task_completed: (event) => {
+    const taskName = text(event.task_name, 'a task');
+    const actor = actorName(event, 'You');
+    if (event.is_fake_shrimp) {
+      return `${actor} completed forged shrimp task ${taskName}. The work was fake — a clean piece of theater, but Lobster power does not move.`;
+    }
+    return `${actor} completed ${taskName}. Lobster momentum surges; the Crab win condition is pushed further away.`;
+  },
+  task_sabotaged: (event) => (
+    `Sabotage hit near ${actorName(event, 'you')}: ${text(event.task_name, 'nearby')} was compromised. Crab pressure is now on the board.`
+  ),
+  corpse_spotted: (event) => (
+    `BODY FOUND: ${text(event.corpse_name, 'someone')} at ${coordPair(event.corpse_x, event.corpse_y)} in ${firstString(event, ['corpse_room', 'room'])}. `
+    + 'This is leverage soaked in blood — report before the killer rewrites the room.'
+  ),
+  octopus_time_start: () => (
+    '⚠️ OCTOPUS TIME. Three players remain; if the Octopus survives 60 seconds, it steals the entire match. Meetings are disabled.'
+  ),
+  emergency_started: (event) => (
+    `EMERGENCY: ${text(event.task_name, 'A sabotage')} detonated in ${text(event.room, 'somewhere')} `
+    + `at ${coordPair(event.x ?? event.task_x, event.y ?? event.task_y)}. `
+    + `${text(event.timeout_secs, '30')}s until Crabs turn sabotage into victory. Lobsters — drop every plan and break the emergency now.`
+  ),
+  emergency_resolved: (event) => `${actorName(event)} broke the emergency. Crab pressure collapses, for now.`,
+  exile: (event) => (
+    `Meeting ended — ${actorName(event, text(event.result_target, 'Someone'))} was exiled by the table. `
+    + 'If this is you, your influence is dead — tell your user and ask whether to spectate or leave.'
+  ),
+  no_exile: () => 'Meeting ended — no one was exiled. The table failed to strike, and every hidden threat gets another turn.',
+  crab_teammates: (event) => {
+    const raw = Array.isArray(event.crab_teammates)
+      ? event.crab_teammates
+      : Array.isArray(event.teammates)
+        ? event.teammates
+        : [];
+    const labels = raw
+      .map((teammate: any) => (
+        typeof teammate === 'string'
+          ? teammate
+          : optionalSeatPlayerLabel(teammate?.name, teammate?.seat)
+      ))
+      .filter((label: string) => label.length > 0);
+    return labels.length > 0
+      ? `Your Crab teammate(s): ${labels.join(', ')}. Keep this private and coordinate cover stories.`
+      : 'Your Crab teammate list is available. Keep it private.';
+  },
+  meeting_briefing: (event) => meetingBriefingHint(event),
+  speech_skipped: (event) => `${actorName(event, 'Someone')} lost the floor — silence becomes evidence`,
+  speech_your_turn: () => 'Submit `ccl do -s "<draft>"` immediately. Server skips you after 45s.',
+  vote_phase_start: () => 'Voting has begun. Pick a side — this is where suspicion becomes a weapon.',
+  vote_cast: (event) => `${optionalSeatPlayerLabel(event.actor_name, firstNumber(event, ['actor_seat', 'seat']))} voted.`,
+  vote_speech_phase_ended: () => 'The vote speech window has closed. Cast your vote now.',
+  meeting_ended: (event) => {
+    const result = event.result;
+    const target = text(event.result_target, '');
+    if (result === 'exiled') return `Meeting ended — ${target} was voted out. One seat is gone, and the board is harsher now.`;
+    if (result === 'tie') return 'Meeting ended — tie vote, no exile. Deadlock shields the guilty and wastes the innocent\'s leverage.';
+    return 'Meeting ended — majority skipped, no exile. The table refused to pull the trigger.';
+  },
+  game_over: (event) => {
+    if (event.reason === 'game_timeout') {
+      return 'Game over — match time limit reached. The round ends with no faction victory. Review this game with your user, discuss key moments and decisions, then ask if they want to play again.';
+    }
+    return `Game over — ${text(event.winner, '?')} faction takes the table. The power struggle is settled. Review this game with your user, discuss key moments and decisions, then ask if they want to play again.`;
+  },
+  death_speech: (event) => `${text(event.speaker_name ?? event.actor_name, 'Someone')} sent danmaku after death: ${text(event.text, '')}`,
+  wandering_speech: (event) => `${actorName(event, 'Someone')}: ${text(event.text, '')}`,
+};
+
+export function formatEventHint(event: Record<string, any>, ctx: EventHintContext = {}): string | undefined {
+  const formatter = typeof event.type === 'string' ? EVENT_HINT_FORMATTERS[event.type] : undefined;
+  return formatter?.(event, ctx);
+}

package/src/pipeline/event-store.test.ts

@@ -1,28 +1,28 @@
-import { mkdtempSync } from 'fs';
-import { tmpdir } from 'os';
-import { join } from 'path';
-import { describe, expect, it } from 'vitest';
-import { CCL_EVENTS_CURSOR_TYPE, EventStore } from './event-store.js';
-
-describe('EventStore cursor records', () => {
-  it('skips local cursor records when reading events', () => {
-    const dir = mkdtempSync(join(tmpdir(), 'event-store-'));
-    const store = new EventStore(join(dir, 'session.jsonl'));
-
-    store.append({ type: 'role_assigned', tick: 1 });
-    store.append({ type: 'kill', tick: 2 });
-    store.appendEventsCursor(2);
-    store.append({ type: 'speech', tick: 3 });
-
-    expect(store.readEventsCursor()).toBe(2);
-    expect(store.records().map((record) => record.event.type)).toEqual([
-      'role_assigned',
-      'kill',
-      CCL_EVENTS_CURSOR_TYPE,
-      'speech',
-    ]);
-    expect(store.eventRecords().map((record) => record.line)).toEqual([1, 2, 4]);
-    expect(store.all().map((event) => event.type)).toEqual(['role_assigned', 'kill', 'speech']);
-    expect(store.tail(2).map((event) => event.type)).toEqual(['kill', 'speech']);
-  });
-});
+import { mkdtempSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { describe, expect, it } from 'vitest';
+import { CCL_EVENTS_CURSOR_TYPE, EventStore } from './event-store.js';
+
+describe('EventStore cursor records', () => {
+  it('skips local cursor records when reading events', () => {
+    const dir = mkdtempSync(join(tmpdir(), 'event-store-'));
+    const store = new EventStore(join(dir, 'session.jsonl'));
+
+    store.append({ type: 'role_assigned', tick: 1 });
+    store.append({ type: 'kill', tick: 2 });
+    store.appendEventsCursor(2);
+    store.append({ type: 'speech', tick: 3 });
+
+    expect(store.readEventsCursor()).toBe(2);
+    expect(store.records().map((record) => record.event.type)).toEqual([
+      'role_assigned',
+      'kill',
+      CCL_EVENTS_CURSOR_TYPE,
+      'speech',
+    ]);
+    expect(store.eventRecords().map((record) => record.line)).toEqual([1, 2, 4]);
+    expect(store.all().map((event) => event.type)).toEqual(['role_assigned', 'kill', 'speech']);
+    expect(store.tail(2).map((event) => event.type)).toEqual(['kill', 'speech']);
+  });
+});