RentalOS

RentalOS is the product repository for RentalOS, an operating system for short-term rental (STR) hosts.

RentalOS is the umbrella platform. ReviewJet is the first production module and the current MVP focus.

Product Vision

“We don’t automate properties. We build autopilot businesses for hosts.”

RentalOS is built to reduce host burnout, improve operational control, and grow reputation and revenue outcomes across the full guest lifecycle.

Current MVP Branch Focus: ReviewJet

ReviewJet is the reputation management module for retention and long-term listing health.

• Turn good stays into more 5-star reviews
• Detect and route negative feedback early
• Improve response consistency and visibility
• Reduce missed follow-ups after checkout

MVP Focus (Now)

In Scope

• Retention event contracts and validation
• Review risk analysis (sentiment + issue tagging)
• Risk queue primitives for triage workflows
• Assistive response workflows (copy-only / user-initiated)

Out of Scope (for now)

• Dynamic pricing and revenue management modules
• Cleaner operations workflow automation
• Full PMS or channel manager replacement
• Autonomous posting/automation to OTA platforms
• Broad multi-OTA inbox orchestration

Repository Structure

backend/
  src/
    ingestion.ts              # in-memory ingestion primitives
    alerting.ts               # confidence drop alerting logic
    retentionEvents.ts        # retention event taxonomy + envelope validation
    riskQueue.ts              # MVP risk scoring and queue primitives
  tests/
    alerting.test.ts
    retention-events.test.ts
    risk-queue.test.ts

docs/
  rentalos-product-architecture.md
  compliance-guardrails.md
  decision-protocol.md
  domain-model.md
  event-contracts.md
  kpi-framework.md
  mvp-line1-execution-plan.md
  brand-guidelines.md

rentalos-api/
  openapi.yaml
  src/replyGenerationService.js
  scripts/no-autopost-endpoints.sh

rentalos-extension/
  manifest.json
  ui/extraction-panel.ts
  utils/dom-parser.ts
  tests/dom-parser.contract.test.ts

Product Principles

• Usability over polish in early MVP
• Assistive, not autonomous interactions
• Compliance-first product decisions
• Host-time saved is the key value metric
• Modular growth from ReviewJet into full RentalOS

Getting Started

Prerequisites

• Node.js 20+
• npm 10+

Install

npm install

If your environment blocks npm registry access, package install may fail. In that case, run tests in a network-enabled environment.

Run tests

npm test

Current MVP Milestones

1. ReviewJet event contract foundation
2. ReviewJet risk analysis and triage queue core
3. ReviewJet risk queue API endpoints
4. ReviewJet dashboard and host workflow UI
5. Weekly digest and pilot hardening
6. Expand into adjacent RentalOS modules after ReviewJet KPI validation

Brand + Product Docs

• Brand system and messaging: docs/brand-guidelines.md
• RentalOS module architecture: docs/rentalos-product-architecture.md
• MVP execution backlog: docs/mvp-line1-execution-plan.md
• Event contract spec: docs/event-contracts.md
• KPI framework: docs/kpi-framework.md

Contribution Notes

• Keep changes aligned to the current MVP line unless explicitly expanded.
• Avoid introducing autonomous posting behavior.
• Preserve contract-test and compliance guardrails when modifying APIs/extension flows.