docs: complete documentation overhaul and changelog update

Author: swadhinbiswas

CHANGELOG.md

@@ -5,32 +5,35 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [1.1.0] - 2026-01-22
 
-### Added
-- **SDK**: Introduced `@opencodehub/sdk`, a TypeScript Client for programmatically interacting with the OpenCodeHub API.
-- **CLI**: Released `opencodehub-cli` (v1.0.1) to npm.
-    - Added `och` command globally.
-    - Implemented smoke tests for CLI verification.
-- **Documentation**:
-    - Added comprehensive "Roadmap" to `README.md` for Q2-Q4 2026.
-    - Added `docs/publishing.md` guide for CLI release management.
-- **Assets**: Updated project logo to SVG format.
+### 📚 Documentation (Major Overhaul)
+- **Structure**: Reorganized `docs/` into a comprehensive knowledge base (`getting-started`, `guides`, `tutorials`, `api`, `administration`).
+- **Visuals**:
+    - Added **Mermaid.js** C4 Architecture diagrams.
+    - Added **Git Graph** diagrams for workflow comparisons.
+    - Created custom SVGs for `stack-workflow` and `architecture`.
+- **New Guides**:
+    - **Production Installation**: Detailed hardware specs, Nginx config, and go-live checklist.
+    - **API Reference**: Swagger-style documentation with JSON examples and parameter tables.
+    - **Troubleshooting**: Solutions for common errors (Docker, 403s, Database).
+    - **CLI Reference**: Unified command list for `opencodehub-cli`.
+    - **Glossary**: Definitions for core terms like "Stacked PRs" and "Merge Queue".
 
-### Changed
-- **Logs**: Cleaned up production code by removing debug `console.log` statements in:
-    - `src/pages/[owner]/[repo]/milestones/index.astro`
-    - `src/pages/[owner]/[repo]/settings/deploy-keys.astro`
-    - `src/pages/[owner]/[repo]/wiki/index.astro`
-    - `src/pages/[owner]/[repo]/actions/index.astro`
-- **Repo Links**: Updated all hardcoded GitHub repository URLs to point to `swadhinbiswas/OpencodeHub`.
+### 💻 CLI (`v1.1.0`)
+- **UI Polish**:
+    - Implemented "Dracula" theme for consistent coloring.
+    - Added ASCII art logo and gradient banners.
+    - Replaced raw logs with animated spinners (`ora`) and progress bars.
+    - Added "Success Boxes" for clearer operation summaries.
+- **Commands**:
+    - `och stack view`: Now displays a visual ASCII tree of the current stack.
+    - `och push`: Shows PR compilation status and links.
 
-### Fixed
-- **Security**: Fixed Critical Authorization Bypass in Issue Creation API (`issues/index.ts`).
-    - Now correctly checks `canReadRepo` before inserting issues.
-- **Security**: Fixed Privacy Leak in Collaborators List API (`collaborators/index.ts`).
-    - Added permission check to prevent unauthorized users from enumerating members of private repositories.
-- **CLI**: Fixed incorrect binary path in `cli/package.json` that prevented global execution.
+### 🛡 Security & Fixes
+- **Authorization**: Fixed critical bypass in `issues/index.ts` and `collaborators/index.ts`.
+- **Fixes**: Resolved incorrect binary path in CLI package.json.
+- **Repo Links**: Updated hardcoded GitHub links to the official repository.
 
 ## [0.2.0] - 2026-01-21
 

README.md

@@ -1,20 +1,28 @@
 # OpenCodeHub
 
 <p align="center">
-  <img src="public/logo.svg" alt="OpenCodeHub Logo" width="200">
+  <img src="public/logo.svg" alt="OpenCodeHub Logo" width="300">
+  <br>
 </p>
 
 <p align="center">
-  <strong>A powerful, self-hosted Git platform with CI/CD, code review, and enterprise-grade security</strong>
+  <strong>The self-hosted Git platform for high-velocity teams.</strong><br>
+  Built for stacked PRs, AI code review, and enterprise security.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/opencodehub-cli"><img src="https://img.shields.io/npm/v/opencodehub-cli?style=flat-square&color=bd93f9&label=CLI" alt="npm version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/swadhinbiswas/OpenCodeHub?style=flat-square&color=50fa7b" alt="License"></a>
+  <a href="https://github.com/swadhinbiswas/OpenCodeHub/actions"><img src="https://img.shields.io/github/actions/workflow/status/swadhinbiswas/OpenCodeHub/ci.yml?branch=main&style=flat-square&color=8be9fd" alt="Build Status"></a>
+  <a href="https://docker.com"><img src="https://img.shields.io/badge/docker-ready-blue?style=flat-square&logo=docker" alt="Docker"></a>
 </p>
 
 <p align="center">
   <a href="#-features">Features</a> •
+  <a href="#-architecture">Architecture</a> •
   <a href="#-quick-start">Quick Start</a> •
-  <a href="#%EF%B8%8F-configuration">Configuration</a> •
-  <a href="#-security">Security</a> •
-  <a href="#-production-deployment">Production</a> •
-  <a href="#-api">API</a> •
+  <a href="#-och-cli---command-line-interface">CLI</a> •
+  <a href="#-advanced-features">Advanced Features</a> •
   <a href="#-contributing">Contributing</a>
 </p>
 
@@ -70,6 +78,25 @@
 
 ---
 
+
+---
+
+## 🏗 Architecture
+
+<p align="center">
+  <img src="public/architecture.svg" alt="System Architecture" width="800">
+</p>
+
+OpenCodeHub is built on a modern, scalable architecture designed for performance and flexibility.
+
+- **Frontend**: Astro + React for high-performance UI.
+- **Backend API**: tRPC + Node.js for type-safe communication.
+- **Git Server**: Custom implementation over standard Git protocols (HTTP/SSH).
+- **Database**: Drizzle ORM supporting PostgreSQL, MySQL, and SQLite.
+- **Storage**: Pluggable storage system (S3, R2, G-Drive, Local).
+
+---
+
 ## 📦 Quick Start
 
 ### Prerequisites
@@ -205,12 +232,10 @@ och status                  # Show stack status (alias: st)
 
 #### How It Works
 
-```text
-main
- └── PR #123: Add database schema
-      └── PR #124: Add authentication service  
-           └── PR #125: Add login UI
-```
+![Stacked PR Workflow](public/stack-workflow.svg)
+<br>
+
+Each PR builds on the previous one. When #123 merges, #124 automatically rebases.
 
 Each PR builds on the previous one. When #123 merges, #124 automatically rebases.
 

cli/CHANGELOG.md

@@ -1,27 +1,67 @@
 # Changelog
 
-All notable changes to this project will be documented in this file.
+All notable changes to OpenCodeHub CLI will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.0.0] - 2026-01-17
+## [1.1.0] - 2026-01-22
 
 ### Added
-- Initial release of OpenCodeHub CLI
-- `och auth` - Authentication commands (login, logout, whoami)
-- `och stack` - Stack management (create, view, submit, sync, reorder)
-- `och init` - Repository initialization
-- `och status` - Stack status display
-- `och config` - Configuration management
-- Support for stacked pull requests
-- Interactive prompts with Inquirer.js
-- Progress spinners with Ora
-- Colorful output with Chalk
-
-### Features
-- Stack-first PR workflow
-- Automatic PR dependency linking
-- Smart stack rebasing
-- Token-based authentication for CI/CD
-- Cross-platform support (Windows, macOS, Linux)
+- 🎨 **Production-Grade UI Overhaul**
+  - GitHub-like progress indicators for push operations
+  - Beautiful ASCII art logos with gradient colors
+  - Real-time upload/download speed indicators
+  - Professional boxed success/error messages
+  - Color-coded output throughout (green=success, red=error, cyan=info)
+  - Smooth spinners for long operations
+  - Object enumeration and compression progress display
+
+- **New Utility Modules**
+  - `branding.ts` - ASCII art, logos, and color schemes
+  - `progress.ts` - GitHub-style progress indicators and formatters
+  - `formatter.ts` - Boxed message formatting
+
+- **UI Dependencies**
+  - `boxen@^7.1.1` - Beautiful bordered boxes
+  - `figlet@^1.7.0` - ASCII art text
+  - `gradient-string@^2.0.2` - Gradient colors
+  - `cli-progress@^3.12.0` - Progress bars
+
+### Changed
+- **Enhanced `och push` command**
+  - Now shows GitHub-style object enumeration
+  - Displays compression progress with thread count
+  - Shows upload speed in real-time
+  - Beautiful ref update notifications
+  - Success box with repository details and view URL
+
+- **Enhanced `och clone` command**
+  - Repository info spinner
+  - Success box with clone location
+  - Helpful next-step commands
+
+- **Enhanced `och create` command**
+  - ASCII celebration art on success
+  - Detailed info box with repository details
+  - Visual indication of public/private status
+  - Shows if remote was added to current repo
+
+### Improved
+- Error messages now appear in formatted error boxes
+- Better visual hierarchy with colors and formatting
+- More professional and polished user experience
+- GitHub-like workflow feel
+
+## [1.0.1] - 2024-XX-XX
+
+### Fixed
+- Minor bug fixes and improvements
+
+## [1.0.0] - 2024-XX-XX
+
+### Added
+- Initial release
+- Basic repository operations (push, clone, create)
+- Authentication system
+- Configuration management