From 9c6edf5697b62d48c11ccacf58e71565111d7c8d Mon Sep 17 00:00:00 2001 From: G <41178744+catomean@users.noreply.github.com> Date: Thu, 3 Sep 2026 09:34:29 +0000 Subject: [PATCH 1/4] docs: honesty pass for README stack, tests, and what works today --- README.md | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index fd674e269..87b9692df 100644 --- a/README.md +++ b/README.md @@ -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) @@ -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/` 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 @@ -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 | @@ -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 From fa965e94d1611870c90990b24a9db1ecd4d6c537 Mon Sep 17 00:00:00 2001 From: G <41178744+catomean@users.noreply.github.com> Date: Thu, 3 Sep 2026 09:34:31 +0000 Subject: [PATCH 2/4] docs: mark 2025-12-30 development README as stale, not Production Ready --- docs/development/README.md | 20 +++++++++++++------- 1 file changed, 13 insertions(+), 7 deletions(-) diff --git a/docs/development/README.md b/docs/development/README.md index 1c2523d68..e4faa39b1 100644 --- a/docs/development/README.md +++ b/docs/development/README.md @@ -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) --- @@ -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 From 2c13787873f869cd586715aaa864680982bcc6d4 Mon Sep 17 00:00:00 2001 From: G <41178744+catomean@users.noreply.github.com> Date: Thu, 3 Sep 2026 09:34:32 +0000 Subject: [PATCH 3/4] docs: mark architecture overview Production Ready status as a 2025 leftover --- docs/architecture/overview.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/architecture/overview.md b/docs/architecture/overview.md index a5b4fd33e..0ea4e8c8d 100644 --- a/docs/architecture/overview.md +++ b/docs/architecture/overview.md @@ -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. --- From 8e6f3b265d098dedb1294da2533a6b8e2abe1804 Mon Sep 17 00:00:00 2001 From: G <41178744+catomean@users.noreply.github.com> Date: Thu, 3 Sep 2026 09:34:33 +0000 Subject: [PATCH 4/4] docs: mark 2025-12-21 database README Production Ready claim as stale --- docs/architecture/database/README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/architecture/database/README.md b/docs/architecture/database/README.md index 4d9a69bc9..01dcac6f2 100644 --- a/docs/architecture/database/README.md +++ b/docs/architecture/database/README.md @@ -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+) @@ -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 @@ -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