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

• Codebase hygiene: удалён мёртвый код (inbound=0) и неиспользуемые экспорты; check:links теперь реально проверяет локальные markdown-ссылки и падает на битых.
• Project Manager: добавлен watchdog-ретрай для cold-open dialog:history — если первый cursor=0 запрос зависает, PM автоматически делает forced retry без ручного клика по session/stage в tree.
• Project Manager: устранена гонка first-open dialog hydration — история из JSONL подтягивается при первом открытии workspace без дополнительного клика по stage/session в tree.
• Project Manager: внедрён единый navigation SSOT (activeStage) — клики в Toolbar, workflow tree и auto-select больше не рассинхронизируют подсветку шага, сессию и правую панель.
• Project Manager: правый header унифицирован для всех workflow-шагов (<Step Name> + Artifacts/Help), добавлены help-панели для Virtual Simulation, Diagram Modules, Diagram Facades.
• Workflow: Virtual Simulation runs in prompt-only mode (no artifact template shipped); the agent writes virtual-simulation.md from Final_Description.md.
• Project Manager: selecting workflow steps from the toolbar/tree opens the stage session UI (e.g. Virtual Simulation) and keeps Sessions + Artifacts panels in sync.
• Session UI: token usage hydration from continuity now includes providerSessionId, fixing 0 tokens / 100% in dialog-mode for Codex sessions.
• Description flow: active runtime/UI path is collector-only for stage description; reviewer auto-runtime and auto-focus branches are removed from current delivery.
• Workflow templates: active ~/.codeai-hub/templates/description/ delivery includes only description-collector-prompt.md, description-template.md, and questionnaire-template.md.
• Template sync: legacy reviewer-prompt.md and reviewer-template.md are pruned from ~/.codeai-hub/templates/description/ during synchronization.
• Release line: stable pre-approval-marker baseline (no .approved.json workflow approval markers).

Previous releases (summary): the 1.1.57x–1.1.69x series focused on SSOT routing (dialog vs runtime), snapshot-first lock/usage authority, continuity/resume reliability across providers, Virtual Simulation workflow, Diagram Modules / Facades workflow, workflow handoff UX, and panel sync 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.