Skip to main content

Changelog

All notable changes to CommonPlace are documented here.

Changes are logged as they happen during development. At the end of each month, entries are archived to maintain readability.

[2026-02-07] - Documentation Accuracy Audit and Fixes​

Type: Documentation

Scope: Full documentation site accuracy verification

Summary: Exhaustive audit of all 124 documentation files against actual source code. Fixed critical inaccuracies including fabricated database schemas, wrong invariants, incorrect function signatures, and missing columns. All docs now verified against real code.

Critical Fixes:

  • philosophy/invariants.md — Replaced entirely with correct 20 invariants from CLAUDE.md
  • database/tables/home_room_settings.md — Rewritten from actual migration (was ~85% fabricated)
  • database/tables/home_room_modules.md — Rewritten from actual migration (was ~85% fabricated)
  • database/tables/circles.md — Fixed column names, FK references, RLS policies
  • database/tables/posts.md — Fixed audience values, can_view_post() param order
  • database/tables/messages.md — Added 4 missing columns, fixed FK targets
  • database/tables/profiles.md — Fixed defaults, updated RLS to block-aware version
  • getting-started/key-concepts.md — Replaced wrong intent names with actual 6 intents
  • database/security.md — Fixed SQL examples, admin model references
  • architecture/file-structure.md — Added missing directories, fixed nonexistent files
  • getting-started/project-structure.md — Updated to match actual directory layout
  • hooks/useFriendship.md — Full rewrite from 2-line stub to complete API docs
  • hooks/index.md — Rewritten to list all 42 hooks (was listing only 16 with wrong names)
  • hooks/useAdminUsers.md — Added auto-fetch clarification
  • components/index.md — Rewritten to list all 26 documented components (was listing only 14)
  • components/Post.md — Fixed authorIntentStyles prop description and access pattern ([post.intent], not [post.user_id][intentCssKey])
  • components/AdvancedComposer.md — Fixed navigation state fields (added 6 missing, removed incorrect voiceData), corrected auto-save storage to IndexedDB
  • components/Feed.md — Fixed default feed mode from "slow" to "normal" (1-hour refresh)

[2026-02-07] - DOC-4: Comprehensive Feature, Component, Hook, and Database Documentation​

Type: Documentation

Scope: Full project documentation

Summary: Created comprehensive documentation for all existing CommonPlace features, components, hooks, and database tables. This covers the entire implemented codebase with accurate details sourced from actual code.

Documentation Created:

  • 12 feature docs: Intent System, Feed, Posts, Friends, Circles, HomeRoom, MeBook, Voice Narration, Advanced Composer, Saved/Shelves, Messaging, Authentication
  • 19 new component docs: SavedPage, Header, Auth, Avatar, Profile, ErrorBoundary, PostDetail, PrivacyCurtain, IntentStylesSettings, AudienceSelector, PostHeader, PostContent, PostActions, PostImages, IntentBadge, SavePopover, Lightbox, ConversationView, NewConversationModal (5 existed from prior session)
  • 41 hook docs: All custom hooks in src/hooks/ documented with signatures, parameters, return values, and usage examples
  • 44 database table docs: All tables documented with schemas, columns, RLS policies, and relationships

[2026-02-07] - Documentation System Initialized​

Type: Documentation

Scope: Project Infrastructure

Summary: Initialized the CommonPlace documentation system using Docusaurus. This provides comprehensive, searchable documentation for all aspects of the project.

Files Changed:

  • docs/* — New documentation site

Documentation Updated:

  • Initial documentation structure created
  • Introduction page
  • Quick start guide
  • Architecture overview placeholder