CodeAI Hub

CodeAI Hub is a Visual Studio Code extension + standalone Project Manager (CEF) that unifies multiple AI providers behind a single, type-safe orchestration layer.

• SolidWorks-WorkFlow docs index: doc/SolidWorks-WorkFlow/Docs_Index.md
• System SSOT: doc/SolidWorks-WorkFlow/System/SystemArchitecture.md
• Session input lock SSOT: doc/SolidWorks-WorkFlow/Contracts/SessionInputLock_SSOT_StateMachine.md
• Bug registry: doc/BugRegistry.md

Current Release — v1.1.752

• Diagram Modules now follows a strict inventory-only contract: module-inventory.md is the only semantic workspace artifact for the stage, while module-map.flow.json remains a layout-only sidecar.
• Diagram Facades now consumes module-inventory.md as its upstream module context, so downstream gating and fresh starts no longer depend on a separate module-map.md.
• Project Manager, runtime prompts, help copy, and workflow gating no longer advertise or wait for a raw module-map.md file in the workspace.
• Diagram Modules and Diagram Facades still use a visual-only manual-layout surface: Auto-layout, profile buttons, Edit Modules, Edit Relations, and the old layout-status chrome are removed from the visible UI.
• module-map.flow.json / facade-map.flow.json continue to persist only user-owned node positions instead of ELK-specific profile state, while React Flow remains the interactive surface for manual correction.
• Semantic changes now flow through agent-driven updates or direct canonical Markdown editing, so the main canvas stays focused on structure and manual layout rather than inline CRUD forms.

Previous releases (summary): the 1.1.57x–1.1.750 series focused on SSOT routing (dialog vs runtime), snapshot-first lock/usage authority, continuity/resume reliability across providers, Virtual Simulation workflow, initial Diagram Modules / Facades workflow, the diagram DSL runtime foundation, PM/UI contract cleanup, corrective runtime/template delivery, the first visual shell release, semantic editing for both diagram stages, bootstrap/gating + parseability recovery for fresh diagram-stage launch, the diagram user-surface recovery that restored Artifacts | Source | Help, repository-wide duplication debt reduction below the enforced release threshold, realtime auto-layout refresh without reopen/remount, and the first inventory-derived diagram release.

Features

• Unified provider orchestration: launch Claude, Codex, or Gemini sessions from an identical picker; the dialog surfaces connection state, enforces one-provider selection, and reminds you to install/authenticate matching CLIs.
• Idea Collector flow: Codex and Claude sessions can launch a guided idea collection flow that produces structured Idea.md drafts.
• Persistent standalone UI: the macOS launcher (CEF) stores window position and size in real time, so Project Manager reopens exactly where you left it—even across monitor changes.
• Offline-first packaging: manifests point to the local ~/.codeai-hub/releases/ cache, and build scripts publish fresh tarballs for core, launcher, and provider modules without relying on GitHub downloads.
• Quality guardrails: Ultracite architecture rules, jscpd duplication scans, ts-prune export checks, and Biome formatting are orchestrated through Husky pre-commit/pre-push hooks.

Getting Started

git clone https://github.com/OleynikAleksandr/CodeAI-Hub.git
cd CodeAI-Hub
npm install

Before starting, read doc/SolidWorks-WorkFlow/Docs_Index.md and follow the SSOT contracts in doc/SolidWorks-WorkFlow/Contracts/ (especially Contracts/Workflow_CLI.md) to configure provider CLIs and SDKs.

Development Workflow

1. Install dependencies

   npm install
   npm run setup:hooks    # installs Husky git hooks

2. Implement changes in src/ and packages/** (micro-classes + facades; keep files under 300 lines).
3. Run quality checks before committing:

   npm run quality        # architecture gate + Ultracite lint
   npm run check:tsprune  # detect unused exports
   npm run compile        # ensure TypeScript builds cleanly

Building a Release

./scripts/build-all.sh
./scripts/build-release.sh --use-current-version

Repository Layout

media/                       Bundled webview assets (CSS + JS) shipped with the extension.
media/react-chat.js          React bundle generated by the webview build script.
src/core/webview-module/     HTML scaffold that injects the webview assets.
src/extension-module/        Extension host micro-classes.
src/extension.ts             Entry point registering the webview provider.
scripts/                     Quality and release automation.
doc/                         Architecture and knowledge base.

License

License information will be added in a future update. Until then, treat the repository as proprietary and request permission before redistribution.