TelivityAI
diff --git a/‎.gitignore‎
Lines changed: 3 additions & 0 deletions b/‎.gitignore‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎CHANGELOG.md‎
Lines changed: 131 additions & 0 deletions b/‎CHANGELOG.md‎
Lines changed: 131 additions & 0 deletions
@@ -34,6 +34,9 @@ drizzle/meta/
 kb/
 briefs/
 instructions/
+# Private research & planning artifacts (belt-and-suspenders, never tracked)
+**/research/
+*.private.md
 
 # Logs
 *.log
 
@@ -0,0 +1,131 @@
+# Changelog
+
+All notable changes to HAIP are documented here. This project adheres to
+[Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+> Version numbers and release tags are assigned automatically by the release
+> workflow on merge — this section is intentionally left as _Unreleased_.
+
+### Added — Reservation Operations
+
+- **Bulk actions** — check-in / check-out / cancel across many reservations in
+  one call, with per-reservation success/error results (never aborts the batch).
+- **Reservation notes** — notes per reservation with active-count tracking.
+- **Guest messaging** — compose and send a message to a reservation's guest;
+  marketing messages respect the guest's GDPR opt-out.
+- **Unassigned-reservation finder** — list confirmed/assigned reservations that
+  have no room assigned, in a date window.
+- **Batch reservation import** — create many reservations from pre-parsed rows
+  with per-row error handling.
+- New `reservation.*` ops webhook events; `reservation_notes` table.
+- **Deliberate non-feature:** reservation status reversion ("un-cancel") is
+  intentionally NOT implemented (payment-integrity hazard, KB §14.8) — enforced
+  by a regression test.
+
+### Added — Groups & Allotment Engine
+
+- **Group profiles** for corporate / travel-agent / wholesale / event business,
+  with an optional group (master) folio and computed group invoices.
+- **Allotment blocks** — hold rooms per date and room type at negotiated rates,
+  with cutoff dates, shoulder dates, and Min/Max LOS. Inventory is validated
+  against live availability to prevent over-allotment.
+- **Cutoff & auto-release** — `POST /groups/blocks/:id/release` plus a
+  `POST /groups/blocks/process-cutoffs` sweep that frees unsold rooms from all
+  expired auto-release blocks back to general inventory (endpoint-triggered; no
+  in-process cron, per repo convention).
+- **Pickup tracking** — rooms allotted vs. picked up per date/room-type.
+- **Rooming lists** — batch import that creates and links member reservations
+  with per-row success/error handling.
+- **Group Pickup Forecasting agent** (new agent type `group_pickup`, 11 agents
+  total) — projects final pickup vs. wash and recommends hold / partial-release
+  / full-release ahead of cutoff.
+- New `group.*` webhook events; `reservations.group_profile_id` added.
+
+### Added — Split Folios & House Accounts
+
+- **House Accounts** — a non-guest ledger for walk-in retail, bar/restaurant,
+  vendor, or internal sales not tied to any reservation. Open/close lifecycle,
+  a `products` retail catalog, and charge/payment posting on the same unified
+  ledger as folios. New `/house-accounts` + `/products` endpoints and
+  `houseaccount.*` webhook events.
+- **Split Folio** — multiple folios per reservation with config-driven routing
+  rules (room & tax → company, incidentals → guest) and move-transactions
+  between folios (individually or by charge type; night-audit-locked charges are
+  protected). New `/folios/routing-rules` and `/folios/:id/move-transactions`
+  endpoints.
+- **Payment Correction Matrix** — `POST /payments/:id/correct` picks the safe
+  operation by payment state: **void** uncaptured authorizations (and same-day
+  cash), **refund** captured cards, or post a compensating **adjustment**.
+  Illegal overrides (e.g. voiding a captured card) are rejected.
+- Schema: `charges`/`payments` now belong to **either** a folio **or** a house
+  account (`folio_id` nullable + nullable `house_account_id`).
+
+### Added — AI Intelligence Layer (accounting)
+
+AI on top of the new accounting layer — a differentiator with no equivalent in
+the baseline feature set. HAIP now ships **10 built-in agents** (was 9).
+
+- **A/R Collections Prioritization agent** (new agent type `ar_collections`) —
+  ranks open Accounts Receivable ledgers by collection priority (balance × days
+  overdue beyond terms × open-transfer count) into low/medium/high tiers with a
+  recommended action.
+- **Cash-variance anomaly detection** — the Night Audit Anomaly agent now scans
+  closed cashier shifts and flags over/short drawer variances
+  (`cash_variance_outlier`, 11 anomaly types total).
+- **Deposit-forfeit risk scoring** — the Cancellation Prediction agent now scores
+  held deposits as likely-forfeit vs. likely-refund with exposure amounts
+  (additive `depositRisk` on each reservation score).
+
+### Added — Accounting & Cashiering
+
+A new accounting layer that makes HAIP's financials correct-by-construction,
+not just functional.
+
+- **Deposit Ledger** — advance deposits are now tracked as a **liability**, not
+  revenue, with a full recognition lifecycle: `held → applied → refunded /
+  forfeited`, including refundable vs. non-refundable handling and
+  status-transition guards. New `/deposits` endpoints and `deposit.*` webhook
+  events.
+- **Accounts Receivable (A/R)** — named A/R ledgers for post-stay direct billing.
+  Transfer an outstanding folio balance to A/R (zeroing the folio), record A/R
+  payments, reverse transfers with a preserved audit trail, and view aging
+  buckets (0–30 / 31–60 / 61–90 / 90+). New `/ar/*` endpoints and `ar.*` webhook
+  events.
+- **Cash Drawer & Cashiering** — per-drawer cash tracking with shift sessions,
+  cash movements (payment, refund, paid-out, drop), shift close with
+  expected-vs-counted **variance** detection, and a cashier's report. New
+  `/cash/*` endpoints and `cashdrawer.*` webhook events.
+- **Daily Trial Balance** — reconciliation across the Deposit, Guest, and A/R
+  ledgers. New `GET /reports/trial-balance` endpoint.
+- **Custom Accounting Codes** — user-defined transaction and General Ledger (GL)
+  codes for export to external accounting systems. New `/accounting/codes`
+  endpoints.
+
+### Changed
+- API surface grew to ~165 endpoints (+66: 20 accounting, 7 cashier, 11 house
+  accounts/products, 3 split-folio, 16 groups/allotment, 8 reservation-ops, plus
+  payment-correct and the trial-balance report).
+- Webhook catalog grew to **64 event types** (+27: 11 accounting, 7 house-account
+  & folio, 6 groups, 3 reservation-ops).
+- Test suite: **691 tests across 61 files** (was 551 across 45), all passing —
+  140 new tests across the accounting, AI-hook, house-account, split-folio,
+  payment-correction, groups/allotment, and reservation-ops features.
+- No manual version bumps — the release workflow tags the next version on merge.
+
+### Notes
+- All new property-scoped tables enforce `property_id` multi-tenancy: every
+  read/update/delete filters by both `id` and `propertyId`.
+- Money math uses `decimal.js` with `numeric(12,2)` storage throughout.
+- 7 new tables and 6 new enums, added to the idempotent `push-schema.ts`
+  migration.
+- The A/R transfer-to-zero is a ledger move (reuses the folio adjustment path),
+  not a payment, per the deposit/A/R domain rules.
+
+## [1.2.5] and earlier
+
+Prior baseline (released via git tags v1.0.0 → v1.2.5): reservations, folios,
+rate plans, rooms, guests, housekeeping, night audit, reports, channel manager,
+payments (Stripe), tax engine, webhooks, Connect API, and the 9-agent AI
+framework. See GitHub Releases for the per-tag history.