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

• Foundation Envelope is removed from the active workflow: trunk now ends at Diagram Modules, and branch design starts directly from Product Part Specification.
• Core and Project Manager no longer treat foundation_envelope as a live stage: workflow state, startup restore, continuity routing, prompt contracts, tree/panel surfaces, localization assets, and regression suites are aligned with the reduced trunk.
• The old FE wave remains history-only: archived plans, TODOs, and release reports are preserved for postmortem traceability around 1.1.905, but the product no longer exposes FE as an active step or supported artifact contract.

Previous releases (summary): 1.1.800–1.1.905 — standalone file-link query decode hotfixes, left-sidebar active-stage sync, temporary Description-first workspace startup, workflow-state startup SSOT alignment, Diagram Modules canonical English naming under localized prose, Codex raw-rollout dialog semantics, Codex empty-terminal answer recovery, the short-lived Foundation Envelope rollout later retired in 1.1.906, and earlier localization/provider/release stabilization waves.

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.
• Description-first workflow: the first guided workflow step is Description, producing questionnaire.md and Final_Description.md as the canonical entry into Virtual Simulation.
• 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, build scripts publish fresh tarballs for core, launcher, and provider modules without relying on GitHub downloads, and the shipped VSIX excludes repository-only Husky hook helpers.
• Quality guardrails: Ultracite architecture rules, jscpd duplication scans, knip dead-code detection, 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
nvm use
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 500 lines).
3. Run quality checks before committing:

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

Public CI

• GitHub Actions now runs a minimal public CI baseline on every push to main and on every pull request.
• The workflow enforces the same root quality gates used as the local baseline: npm run check:architecture, npm run lint, npm run check:knip, and npm run compile.
• The root compile gate now builds @codeai-hub/translation, @codeai-hub/localization, and @codeai-hub/core-supervisor before browser/root type-check, so clean GitHub runners do not depend on pre-existing workspace dist/ folders.
• Local Husky hooks remain the fastest feedback path; CI is the public verification surface, not a replacement for the local release ritual.

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

This repository is currently distributed as UNLICENSED. Source is visible for audit and development collaboration, but redistribution requires explicit permission from the repository owner.