Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 16 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@

Your AI economic agent — and the platform where it operates.

[![TypeScript](https://img.shields.io/badge/TypeScript-5.8-blue.svg)](https://www.typescriptlang.org/)
[![Next.js](https://img.shields.io/badge/Next.js-15-black.svg)](https://nextjs.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-6-blue.svg)](https://www.typescriptlang.org/)
[![Next.js](https://img.shields.io/badge/Next.js-16-black.svg)](https://nextjs.org/)
[![Live](https://img.shields.io/badge/Live-orangecat.ch-orange.svg)](https://orangecat.ch)
[![Bitcoin](https://img.shields.io/badge/Bitcoin-Native-F7931A.svg)](https://bitcoin.org)

Expand All @@ -13,26 +13,26 @@ Economic participation still requires gatekeepers. To sell, fund, lend, invest,

## The Solution

OrangeCat is an AI-native platform for universal economic participation. Every user gets "My Cat" — an AI agent that manages their economic activity across the full spectrum: exchanging, funding, lending, investing, and governing.
OrangeCat is an AI-native platform for universal economic participation. The live wedge is a Bitcoin Lightning pay link. "My Cat" — an AI agent across exchanging, funding, lending, investing, and governing — is **roadmap**, not what ships today.

- **Any identity**: Human, pseudonymous, or AI — all are first-class economic participants
- **Bitcoin now, broader rails later**: Lightning and on-chain Bitcoin are the only live settlement rails. Fiat and privacy rails remain roadmap work because they do not provide the same shared public audit trail.
- **Full economic spectrum**: From gifts (no strings) to loans (some strings) to investments (more strings)
- **Full economic spectrum (roadmap beyond the pay link)**: From gifts (no strings) to loans (some strings) to investments (more strings)
- **Private where needed, transparent where chosen**: E2E encrypted messaging, on-chain transparency when appropriate

## What Works Today

- **Commerce**: Products and services with Bitcoin Lightning payments
- **Funding**: Account-free Bitcoin support for public projects and other supportable entities
- **Lending**: Peer-to-peer loans with repayment tracking
- **Assets**: Real estate, collateral, and rentable asset management
- **Groups**: Organizations with shared wallets, governance proposals, and collective decision-making
- **AI Assistants**: Autonomous economic actors as first-class entities
- **Events**: Time-bound coordination with ticketing
- **Documents**: Structured context for the AI agent
- **Cross-product customers**: Live example of FleetCrown (production) as customer of OrangeCat (economic), using typed stakeholder edges + shared wallets + profiles as projects.
- **Pay link (the wedge)**: every user gets `orangecat.ch/pay/<username>` for Bitcoin Lightning payments. **0 completed payments** as of the 2026-07-02 production note.
- **Live site**: [orangecat.ch](https://orangecat.ch)
- **Shipped surfaces**: product/service listings, groups, events, documents, and related entity types exist on the live site. That is not the same as a working funding, lending, or investing economy.
- **FleetCrown dogfood**: FleetCrown (live at [fleetcrown.orangecat.ch](https://fleetcrown.orangecat.ch)) uses OrangeCat as a sibling product — typed stakeholder edges, shared BTC wallet, profiles as projects. This is internal dogfood, **not** an external or institutional customer. There are no institutional customers.

Live at [orangecat.ch](https://orangecat.ch). FleetCrown is a live "customer" of OrangeCat (see projects "OrangeCat" and "FleetCrown" under Mao Nakamoto). Shared BTC wallet. The stakeholder_relationships feature (8 kinds incl. customer) was made production-ready here for this use case — works for all.
## Roadmap (not what works today)

- **Funding**: account-free Bitcoin support for public projects
- **Lending**: peer-to-peer loans with repayment tracking
- **Investing**: investment flows beyond the pay-link wedge
- **The Cat**: AI agent that manages economic activity across the full spectrum

## Architecture

Expand Down Expand Up @@ -69,7 +69,7 @@ Functional composition replaces inheritance. Each middleware does one thing.

| Layer | Technology |
| ---------- | ---------------------------------------------------------------------------------------- |
| Framework | Next.js 15, React 18, TypeScript 5.8 |
| Framework | Next.js 16.2, React 19, TypeScript 6 |
| Styling | Tailwind CSS, shadcn/ui |
| Database | Self-hosted Supabase (PostgreSQL + Auth + RLS) on Hetzner |
| Bitcoin | Lightning Network, LNURL, bitcoinjs-lib |
Expand Down Expand Up @@ -122,7 +122,7 @@ src/

## Testing

17 test suites, 74 tests. Pre-push hooks run type-check, lint, and the full test suite before any code reaches the remote.
2648 unit tests across 282 files (CI as of 2026-09-02). Pre-push hooks run type-check, lint, and the full test suite before any code reaches the remote.

## Security

Expand Down
8 changes: 4 additions & 4 deletions docs/architecture/database/README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# 🗄️ Database Architecture Documentation

**Overall Rating: 9.2/10** ⭐⭐⭐⭐⭐ | **Status: Production Ready** | **Simplified MVP Architecture** 🚀
**Overall Rating: 9.2/10** (2025 self-score) | **Status: Stale 2025-12-21 snapshot — not a current Production Ready claim** | **Simplified MVP Architecture**

> Last Updated: December 21, 2025
> Last Updated: December 21, 2025 (stale; honesty pass 2026-09-03)
> Database: Supabase PostgreSQL
> Version: Production v2.0 (Simplified)
> Tables: 5 core tables (down from 10+)
Expand Down Expand Up @@ -58,7 +58,7 @@
- **Multi-Entity Transactions** - Any entity can donate to any other
- **Bitcoin Wallet Support** - Lightning/Bitcoin addresses for all entities
- **Row Level Security** - Comprehensive access control
- **Production Ready** - Optimized for scalability and performance
- **2025 snapshot claimed production-ready** - do not treat as today's gate
- **3 Helper Functions** - Wallet balance and transaction history queries
- **15+ RLS Policies** - Comprehensive security coverage
- **15+ Indexes** - Strategic performance optimization
Expand Down Expand Up @@ -209,4 +209,4 @@ ORDER BY idx_scan ASC;

---

**Status**: Production Ready | **Rating**: 9.2/10 | **Architecture**: Simplified MVP | **Last Updated**: December 21, 2025
**Status**: Stale 2025-12-21 snapshot (not a current Production Ready claim) | **Rating**: 9.2/10 (then) | **Architecture**: Simplified MVP | **Last Updated**: December 21, 2025
4 changes: 3 additions & 1 deletion docs/architecture/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,11 @@

**Created:** 2025-10-13
**Last Modified:** 2025-01-20
**Status:** Production Ready
**Status:** Stale 2025 snapshot — not a current "Production Ready" claim
**Purpose:** Define clear boundaries between entities and their relationships in the simplified MVP architecture

> Honesty pass 2026-09-03: this document's "Production Ready" status was a 2025 leftover. OrangeCat is live at orangecat.ch; do not treat this file as today's readiness gate.

> 📖 **Long-Term Vision**: See [LONG_TERM_VISION.md](./LONG_TERM_VISION.md) for the complete vision including Assets, Events, and Organizations with multi-entity associations.

---
Expand Down
20 changes: 13 additions & 7 deletions docs/development/README.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,25 @@
# Development Documentation

**Last Updated:** 2025-12-30
**This page is a 2025-12-30 snapshot. It is not a current production-readiness statement. Do not read "Production Ready" below as today's status.**

**Last Updated of this snapshot:** 2025-12-30
**Honesty pass:** 2026-09-03 — OrangeCat is live at [orangecat.ch](https://orangecat.ch). Treat the architecture notes as historical unless re-verified.

---

## Current Status: Production Ready
## Snapshot status (2025-12-30 — stale)

The 2025-12-30 header said "Production Ready". That claim is **stale**. The linked Production Readiness Handoff at `docs/development/HANDOFF_PRODUCTION_READINESS.md` **404s**; a copy lives at [`docs/archive/2026-h1/HANDOFF_PRODUCTION_READINESS.md`](../archive/2026-h1/HANDOFF_PRODUCTION_READINESS.md). Remaining-work figures from that snapshot (~460 TypeScript errors, ~160 `console.log`s) are **not** current gates.

**Then (snapshot notes, not today's gate):**
**Build:** Passing
**Database:** Verified (3 groups, 17 actors, 3 members)
**Groups Unification:** Complete
**Actor System:** Implemented

### Active Status Documents
- **[Production Readiness Handoff](./HANDOFF_PRODUCTION_READINESS.md)** - Current production status & next steps
- **[Active Refactoring Tasks](./ACTIVE_REFACTORING_TASKS.md)** - Current work tracker
- **[Archived Production Readiness Handoff](../archive/2026-h1/HANDOFF_PRODUCTION_READINESS.md)** - 2025 snapshot; the original `./HANDOFF_PRODUCTION_READINESS.md` 404s
- **[Active Refactoring Tasks](./ACTIVE_REFACTORING_TASKS.md)** - 2025 work tracker (also dated; re-verify before trusting)

---

Expand Down Expand Up @@ -73,10 +79,10 @@

---

## Remaining Work
## Remaining Work (from the 2025-12-30 snapshot — not a current inventory)

1. **TypeScript Errors** - ~460 non-blocking errors remain
2. **Console.log Cleanup** - ~160 statements to replace with logger
1. **TypeScript Errors** - snapshot cited ~460 non-blocking errors; do not treat as today's count
2. **Console.log Cleanup** - snapshot cited ~160 statements to replace with logger
3. **Delete Old Components** - ModernProjectCard, DashboardProjectCard after testing
4. **Remove Organizations Table** - After verification period

Expand Down
Loading