Add @bgstm/domain-saas-workflows stub package for cross-channel AI receptionist workflows

[Copilot]

This PR adds a fourth domain package, @bgstm/domain-saas-workflows, at stub maturity to cover cross-channel SaaS workflow automation not well represented by CRM/accounting-only packs. It introduces minimal package scaffolding, typed factories, and stub POMs across AI receptionist, scheduling, and CRM-from-call flows.

• Package scaffold

  • Added packages/domain-saas-workflows/ with package.json (0.0.1, Apache-2.0, required keywords, matching peer/dev dependency pattern), tsconfig.json, and ESM entrypoints.
  • Added root README.md packages-table row for @bgstm/domain-saas-workflows with 🚧 Stub status.

• Workflow page object stubs

  • Added:
    • src/receptionist/ReceptionistPage.ts
    • src/scheduling/SchedulingPage.ts
    • src/crm/CrmFromCallPage.ts
  • Included required method signatures + JSDoc with stub bodies (throw new Error("Not yet implemented — stub")).
  • Added Playwright Page constructors so example usage aligns with class shape.

• Typed domain model + factories

  • Added src/types.ts with minimal realistic interfaces:
    InboundCall, CallTranscript, AvailabilitySlot, Appointment, Contact, Lead, Intent, LifecycleStage.
  • Added factory modules:
    • src/factories/callFactory.ts
    • src/factories/appointmentFactory.ts
    • src/factories/contactFactory.ts
  • Factories return typed defaults with override support ({ ...defaults, ...overrides }).

• Docs and usage example

  • Added package README with stub status, install snippet, “Why this pack” (cross-channel/multi-actor positioning), flow table, roadmap, and NAT regulated-industries footer.
  • Added runnable-looking BGSTM annotation example at:
    examples/ai-receptionist.spec.example.ts.

test(
  'books an appointment from an inbound AI receptionist call',
  { annotation: { type: 'bgstm:requirement', description: 'REQ-SAAS-WF-001' } },
  async ({ page }) => {
    const receptionist = new ReceptionistPage(page);
    await receptionist.simulateInboundCall(makeInboundCall());
  },
);