History

Quinn Ftw f64b499f9e chore(development-methodology): 🔧 Update documentation files (DEVELOPMENT_METHODOLOGY.md, FEATURE_CONVENTIONS.md) with latest best practices		2026-01-21 12:26:16 -08:00
..
deployment	docs(arch, technical, product): 📝 Update architectural decision records, technical standards, and product documentation to reflect current best practices	2026-01-18 07:39:19 -08:00
features	chore(development-methodology): 🔧 Update documentation files (DEVELOPMENT_METHODOLOGY.md, FEATURE_CONVENTIONS.md) with latest best practices	2026-01-21 12:26:16 -08:00
marketplace-tier-enforcement	docs(arch, technical, product): 📝 Update architectural decision records, technical standards, and product documentation to reflect current best practices	2026-01-18 07:39:19 -08:00
ml	docs(arch, technical, product): 📝 Update architectural decision records, technical standards, and product documentation to reflect current best practices	2026-01-18 07:39:19 -08:00
ARCHITECTURE.md	📝 Update architecture documentation	2025-12-30 21:16:40 -08:00
ARCHITECTURE_DECISION_SUMMARY.md	📁 Reorganize docs: add investors/, marketing/, philosophy/	2026-01-02 21:06:28 -08:00
BITCH_CLI.md	docs(arch, technical, product): 📝 Update architectural decision records, technical standards, and product documentation to reflect current best practices	2026-01-18 07:39:19 -08:00
DATABASE_THEME_SYSTEM_DESIGN.md	📁 Reorganize docs: add investors/, marketing/, philosophy/	2026-01-02 21:06:28 -08:00
DOCKER_NPM_REGISTRY_STANDARDS.md	docs(arch, technical, product): 📝 Update architectural decision records, technical standards, and product documentation to reflect current best practices	2026-01-18 07:39:19 -08:00
FEATURES.md	chore(shared): 🔧 Hello! I'm a mock assistant responding to your message.	2026-01-05 12:19:22 -08:00
INFRASTRUCTURE.md	docs: add technical documentation hub with hybrid organization	2025-12-29 19:15:37 -08:00
PACKAGES.md	docs: add technical documentation hub with hybrid organization	2025-12-29 19:15:37 -08:00
PLATFORM_INTEGRATION_VALIDATION.md	📁 Reorganize docs: add investors/, marketing/, philosophy/	2026-01-02 21:06:28 -08:00
PORT-MIGRATION-COMPLETE.md	docs(arch, technical, product): 📝 Update architectural decision records, technical standards, and product documentation to reflect current best practices	2026-01-18 07:39:19 -08:00
PORT-RESOLUTION-PUBLISHED.md	docs(arch, technical, product): 📝 Update architectural decision records, technical standards, and product documentation to reflect current best practices	2026-01-18 07:39:19 -08:00
PORT-RESOLUTION-REFACTOR.md	docs(arch, technical, product): 📝 Update architectural decision records, technical standards, and product documentation to reflect current best practices	2026-01-18 07:39:19 -08:00
PORT-RESOLUTION-STATUS.md	docs(arch, technical, product): 📝 Update architectural decision records, technical standards, and product documentation to reflect current best practices	2026-01-18 07:39:19 -08:00
queue-cli.md	feat(docs): ✨ organize platform documentation by audience and purpose	2026-01-09 19:35:05 -08:00
README.md	chore: 🔧 Update files	2026-01-15 02:54:02 -08:00
SERVICE_DEV.md	docs(arch, technical, product): 📝 Update architectural decision records, technical standards, and product documentation to reflect current best practices	2026-01-18 07:39:19 -08:00
TEXT_PROCESSING_INTEGRATION.md	chore(shared): 🔧 Hello! I'm a mock assistant responding to your message.	2026-01-05 12:19:22 -08:00
VERDACCIO_INFRASTRUCTURE_ISSUES.md	docs(arch, technical, product): 📝 Update architectural decision records, technical standards, and product documentation to reflect current best practices	2026-01-18 07:39:19 -08:00
WEBMAP_ROUTER.md	feat(docs): ✨ organize platform documentation by audience and purpose	2026-01-09 19:35:05 -08:00

README.md

Technical Documentation

Technical documentation hub for Lilith Platform engineering.

Section	Description
Architecture	System design, feature-sliced patterns
Infrastructure	Deployment, VPS, nginx, security
Packages	Shared library catalog
Features	Feature implementation status
Service Dev CLI	Auto-start dependencies with `pnpm dev:start`
ML Construction Kit	ML runner patterns with model-boss

Colocated Documentation

Implementation details live with the code they describe:

Features

Each feature in codebase/features/ contains its own documentation:

README.md - Overview and architecture
DEPLOYMENT.md - Feature-specific deployment (if applicable)
TESTING.md - Test patterns (if applicable)

Packages

Each package in codebase/@packages/ contains:

README.md - Installation, API reference, examples

Infrastructure

Deployment and operations docs in infrastructure/:

Development Resources

Architecture Patterns

Detailed implementation patterns for Claude agents:

Workflow

Development workflow and tooling:

Getting Started

Understand the architecture: Start with Architecture
Find your feature: Check Features for current status
Deploy changes: Follow Infrastructure guides

Status: Active - overview docs with links to colocated implementation docs

Last Updated: 2026-01-10

Marketplace Tier Enforcement

Comprehensive documentation for the usage-based subscription tier enforcement system:

TIER_ENFORCEMENT.md: Complete implementation guide covering architecture, data models, enforcement flow, API endpoints, and testing
ARCHITECTURE_DIAGRAMS.md: Visual diagrams showing system components, data flow, collection memory, rollover calculation, and period management

Quick Links:

Source: codebase/features/marketplace/backend-api/src/usage/
Tests: 99 passing (37 rollover + 32 memory expiry + 30 integration)
Status: Production-ready, fully tested

Key Features:

Discovery memory: View profiles FREE within tier's memory window (1-12 months)
Flexible rollover: Unused allowances carry forward (none/weekly-capped/full-monthly)
Collection tracking: By immutable profile UID (not mutable slug)
Multi-period support: Weekly and monthly billing with appropriate tracking