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.647

• Session UI (BUG-2026-02-22-01): fixes “stuck locked/resuming” states on cold start and after Core restarts mid-turn — input unlocks snapshot-first (turnState=idle + continuityLockActive=false) even if continuityLockReason is missing; no manual unlock needed, and “Продолжай” continues the interrupted turn.
• Project Manager: adds regression coverage + aligns snapshot application so missing continuityLockReason cannot keep input blocked when the snapshot is already idle/unlocked.
• Core / Workspace snapshots: normalizes idle resume-in-place sessions to emit an explicit unlock hint continuityLockReason="no_rollover_needed" (defense-in-depth; reason is never a hard unlock gate).
• Docs: recut release build with up-to-date README.md + CHANGELOG.md (release notes are updated before packaging).

Previous releases (summary): the 1.1.57x–1.1.64x series focused on SSOT routing (dialog vs runtime), snapshot-first lock/usage authority, continuity/resume reliability across providers, and workflow handoff UX in Project Manager.

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

Перед запуском прочитайте doc/SolidWorks-WorkFlow/Docs_Index.md и следуйте SSOT-контрактам из doc/SolidWorks-WorkFlow/Contracts/ (в частности Contracts/Workflow_CLI.md) для настройки провайдерных CLI/SDK.

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.