Sharpee Platform Status

// Type-safe event creation
const event = createTypedEvent('if.event.taken', {
  actor: playerId,
  target: lampId,
  from: roomId
});

// Type guards narrow the type
if (isEventType(event, 'quit.confirmed')) {
  console.log(event.data.finalScore);  // TypeScript knows this exists
}

// Safe data extraction with defaults
const { message, hint } = getEventDataWithDefaults(event, 'query.invalid', {
  message: 'Invalid response.',
  hint: undefined
});

// Context-aware vocabulary slots
vocab.define('panel-colors', {
  words: ['red', 'yellow', 'mahogany', 'pine'],
  when: (ctx) => ctx.currentLocation === insideMirrorId
});

grammar.define('push :color panel')
  .fromVocabulary('color', 'panel-colors')
  .mapsTo('push_panel')
  .build();

// Manner adverbs (16 built-in)
grammar.define(':manner open :target')
  .manner('manner')
  .mapsTo('open')
  .build();
// "carefully open door" -> command.manner === 'carefully'

// Direction slots with automatic constant conversion
grammar.define('push :direction wall')
  .direction('direction')
  .mapsTo('push_wall')
  .build();

// Check if actor can perceive via a specific sense
const canSee = perception.canPerceive(actor, location, world, 'sight');
const canHear = perception.canPerceive(actor, location, world, 'hearing');

// Filter events based on perception
const filtered = perception.filterEvents(events, actor, location, world);
// Visual events in darkness -> perception.blocked events

// Event flow with perception:
Action executes
    -> Events generated (room.description, contents.listed, etc.)
    -> PerceptionService.filterEvents()
       - Visual events in dark -> perception.blocked
       - Non-visual events pass through
    -> TextService renders

# CLI commands
sharpee ifid generate
# -> 621168D1-6D5C-449F-83D5-841D03A1BF78

sharpee ifid validate 621168D1-6D5C-449F-83D5-841D03A1BF78
# -> Valid IFID

# Programmatic usage
import { generateIfid, validateIfid, normalizeIfid } from '@sharpee/core';

const ifid = generateIfid();  // UUID v4, uppercase
validateIfid(ifid);           // Treaty of Babel: 8-63 chars, A-Z/0-9/-
normalizeIfid(ifid);          // Uppercase conversion